Skip to content

Comment on Ask HN: What is your personal motivation for documenting code?

Comments

You are scaling yourself - So you have more time to focus on tasks that matter.

Rather than answering the same questions repeatedly, you can point other teammates to your doc.

It’s also not just a one time thing - Once the docs started gaining traction, you will see your teammates contributing. It takes time to get there, but it will get better over time, and it’s worth it.

Downside 1. Docs can get outdated - There will be times you need to go and refactor the docs. 2. You won’t get promoted because you wrote good docs.

AboutSource Built by g1lg1l

Hackerly is an independent reader for Hacker News, built on the public HN API. Not affiliated with Y Combinator.