3 ms·
Author, please rewrite this. My suggestions: 1) Delete the first two paragraphs. 2) Tell me what you're going to tell me, but without all the highlights and b
by 0xbadcafebee 3y ago
Author, please rewrite this. My suggestions:
1) Delete the first two paragraphs.
2) Tell me what you're going to tell me, but without all the highlights and bullet points.
3) Sell me on why I want to read this article. Don't focus on the technical; focus on the human, what I as a person will get from it.
4) In later technical sections, don't give me instructions. Tell me what you are doing in general to solve some problem, then just show me the commands, and I will infer that I could also do X, do Y, do Z.
5) If you want to give a lot of technical detail and backstory, either put it in an expand, or in some kind of colored box so I have the visual context that I can probably skip this whole, continue the story, and come back to this later.
6) The recap shouldn't be larger than two paragraphs.