Hacker News new | past | comments | ask | show | jobs | submit login

I don't fear writing documents, but i do work with a lot of people who do fear reading! I've found a really good trick is to highlight key figures or a few standout grabs in the early paragraphs of the text and then to have more substantial higlights towards the meaty parts of the document.

Essentially it's like having the bullet points and full document in one. It;s resulted in a lot of people getting interested up top and being tricked into reading down the bottom.

Give it a try sometime.




For sure. Part of being a successful writer is communicating in a way that is most effective for your audience.

Rarely is a wall-of-text the right answer. Bullet points, flow diagrams, and examples are all helpful techniques when writing for engineers.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: