Hacker News new | past | comments | ask | show | jobs | submit login

I comment my code[0].

I don't particularly care what people think about it.

I will say that I have turned over a lot of code, over the years, and virtually never get asked about what it does. When people ask me about my code, I generally tell them where to look, and contact me if they need explanations.

I don't get contacted, so I guess they could figure it out.

I also tend to write a lot of supporting documentation.

We do have to be careful, though. Documentation can easily become "concrete galoshes"[1], so things like header/auto documents are pretty important.

[0] https://medium.com/chrismarshallny/leaving-a-legacy-1c2ddb0c...

[1] https://medium.com/chrismarshallny/concrete-galoshes-a5798a5...




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: