Hacker News new | ask | show | jobs
by bheadmaster 1284 days ago
I find that the process of writing text is similar to writing code.

You can't just keep piling lines upon lines, at some point you have to stop, re-read everything you've wrote, refactor it, make it simpler, more concise, remove the outdated text/code, etc. etc.

Documentation should always have one global "root" document, which contains links to everything else, and the documentation graph should be regularly reviewed and pruned.