Hacker News new | ask | show | jobs
by hprotagonist 2030 days ago
https://www.biorxiv.org/content/10.1101/088278v5.full.pdf is broadly applicable to technical writing. The C-C-C scheme outlined there is excellent.

I strongly recommend the active voice.

1 comments

Interesting read. Context-Content-Conclusion. Specially how it categorizes readers in two categories impatient and patient readers and addresses concerns of both.

> The C-C-C scheme that we advocate serves a more patient reader, who is willing to spend the time to get oriented with the context. A consequent disadvantage of C-C-C is that it may not optimally engage the impatient reader.