Hacker News Reader

Ridiculing the value of documentation does not make you look smart.

It rather hints at lack of experience with truly complex systems or collaboration in teams.

Are you saying this is a complex system or that any decisions made in the context of complex systems must be used for all software? Also, this was not in response to a post about documentation but rather a post about the file names. In any event, it says nothing about my experience and you are simply extrapolating.

You can always write documentation in comments. Using terse names for the identifiers when feasible can make it a lot easier to see the bigger picture wrt. multiple components interacting. It's a tradeoff.

Agreed, and it would probably be my preference.

The code referenced here is pretty extreme NOT providing the guidance, hence my response to the poster defending the extreme and ridiculing the good practice.

Reply on news.ycombinator.com