Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

All good writing is about narrative. What a compelling narrative means is different for a technical document and a mystery novel, but narrative is the bedrock.

So make sure that things are motivated, and try to not just tell the reader the facts, but take them on a journey such that they will wind up with the right facts AND the right mental model at the end of things.



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

Search: