Hacker News new | ask | show | jobs
by cema 3139 days ago
Document your decisions, explain assumptions, limitations, and reasoning. It helps immensely.
1 comments

Indeed, I also started moving from documenting what code does to explain what I intend the code to accomplish (because code already explains clearly find what it does by itself). By communicating at this level the overarching idea does not get lost and allows for much better refactoring or debugging.