Hacker News new | ask | show | jobs
by kashyapc 1284 days ago
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