Re:Writing Is Magic
by bheadmaster on Thursday December 08, 2022 @11:06AM
(#33909425)
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.
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.