Hacker News new | ask | show | jobs
by jononor 318 days ago
There is a hack for that: write the comments before and/or as you write the code. When things are still unclear, weird. Of course do a final pass on them to ensure that they are correct and useful in the end. This is one example of document as-you-go, instead of doing it after "the work" is done. I find it generally leads to better outcomes. Doing documenting only at the end is in many ways the worst way to do it.
1 comments

the comments before are basically requirement in confluence or whatever app is used to capture them :)