News for hackers. Stuff that matters.
Re:Writing Is Magic by kashyapc on Thursday December 08, 2022 @12:01PM (#33910217)
Yes, that "wall of text" is a real problem, especially by those who don't realize that "everyone is in a hurry" almost all the time. I solve it by first adding a top-level "executive summary" with all the critical information, followed by a "Details" section with nicely formatted lists with fully-dressed sentences.

And definitely check out the book "Style: Towards Clarity and Grace" by Joseph Williams and Gregory Colomb (there are several editions of this; but any earlier edition would do; I have the 10th edition). I wrote a bit more about it here[1] in the past.

[1] https://news.ycombinator.com/item?id=24272968

There are no comments on this comment yet.