Hacker News Reader

As a programmer I always write code considering if a new guy wants to take over my code, he should be able to understand it and use my code with as little complication as possible. Things should be simple enough that when a new guy takes over your code he can be onboarded soon and doesn't have to ask someone to explain him the magic pattern or secret sauce to under teams code.

View on HN

I am some what the opposite. The person that comes after me should be able to read and understand what I wrote without line by line documentation. If they can't, they are not fit for the position. Although, if there is a quirk within the code where something needs to be explained, it will have documentation.

I think you're agreeing with each other. Parent never specifically mentioned writing documentation. I took their post to mean that the code should be easy to understand.

You are right, I jumped the gun and read the opposite. Cheers. Sorry Parent.

Reply on news.ycombinator.com