5 ms·

Hey, thanks for sharing your thoughts! I appreciate you putting this out there. One bit of hopefully constructive feedback: your previous post ran about 60 pri

Hey, thanks for sharing your thoughts! I appreciate you putting this out there. One bit of hopefully constructive feedback: your previous post ran about 60 printed pages, this one's closer to 40 (just using that as a rough proxy for time-to-read). I’ve only skimmed both for now, but I found it hard to pin down the main purpose or takeaway. An abstract-style opening and a clear conclusion would go a long way, like in academic papers. I think that makes dense material way more digestible.

danabramov 1y ago
There's a recap for each major section: - https://overreacted.io/jsx-over-the-wire/#recap-json-as-components https://overreacted.io/jsx-over-the-wire/#recap-json-as-comp... - https://overreacted.io/jsx-over-the-wire/#recap-components-as-json https://overreacted.io/jsx-over-the-wire/#recap-components-a... - https://overreacted.io/jsx-over-the-wire/#recap-jsx-over-the-wire https://overreacted.io/jsx-over-the-wire/#recap-jsx-over-the... I don't think I can compress it further. Generally speaking I'm counting on other people carrying useful things out of my posts and finding more concise formats for those.
- yawaramin 1y ago
  Try the BLUF style: https://www.animalz.co/blog/bottom-line-up-front/ https://www.animalz.co/blog/bottom-line-up-front/
- emmanueloga_ 1y ago
  From my perspective, the article seems primarily focused on promoting React Server Components, so you could mention that at the very top. If that’s not the case, then a clearer outline of the article’s objectives would help. In technical writing, it’s generally better to make your argument explicit rather than leave it open to reader interpretation or including a "twist" at the end. An outline doesn't have to be a compressed version, I think more like a map of the content, which tells me what to expect as I make progress through the article. You might consider using a structure like SCQA [1] or similar. -- 1: https://analytic-storytelling.com/scqa-what-is-it-how-does-it-work-and-how-can-it-help-me/ https://analytic-storytelling.com/scqa-what-is-it-how-does-i...
  - danabramov 1y ago
    I appreciate the suggestions but that’s just not how I like to write. There’s plenty of people who do so you might find their writing more enjoyable. I’m hoping some of them will pick something useful in my writing too, which would help it reach a wider audience.

danabramov 1y ago

There's a recap for each major section: - https://overreacted.io/jsx-over-the-wire/#recap-json-as-components https://overreacted.io/jsx-over-the-wire/#recap-json-as-comp... - https://overreacted.io/jsx-over-the-wire/#recap-components-as-json https://overreacted.io/jsx-over-the-wire/#recap-components-a... - https://overreacted.io/jsx-over-the-wire/#recap-jsx-over-the-wire https://overreacted.io/jsx-over-the-wire/#recap-jsx-over-the... I don't think I can compress it further. Generally speaking I'm counting on other people carrying useful things out of my posts and finding more concise formats for those.

yawaramin 1y ago
Try the BLUF style: https://www.animalz.co/blog/bottom-line-up-front/ https://www.animalz.co/blog/bottom-line-up-front/
emmanueloga_ 1y ago
From my perspective, the article seems primarily focused on promoting React Server Components, so you could mention that at the very top. If that’s not the case, then a clearer outline of the article’s objectives would help. In technical writing, it’s generally better to make your argument explicit rather than leave it open to reader interpretation or including a "twist" at the end. An outline doesn't have to be a compressed version, I think more like a map of the content, which tells me what to expect as I make progress through the article. You might consider using a structure like SCQA [1] or similar. -- 1: https://analytic-storytelling.com/scqa-what-is-it-how-does-it-work-and-how-can-it-help-me/ https://analytic-storytelling.com/scqa-what-is-it-how-does-i...
- danabramov 1y ago
  I appreciate the suggestions but that’s just not how I like to write. There’s plenty of people who do so you might find their writing more enjoyable. I’m hoping some of them will pick something useful in my writing too, which would help it reach a wider audience.