Hacker News new | ask | show | jobs
by raytopia 832 days ago
Yeah, code gets rewritten a lot because there's a intentional lack of documentation. Not entirely sure how people decided that comments are bad or that commenting is more harmful than not.

This may just be me but does anyone else actually enjoy documenting their code?

2 comments

You can always make your code self explanatory, but the cost in abstraction and maintenance results sometimes a negative ROI. In such cases, writting comments is often the best solution.

There's some excitment in identifying those, and that's where I enjoy documenting the intention of my code.

>You can always make your code self explanatory

this code is done in this way because EU regulation #1374 regarding Maritime tracing.

this code seems inefficient and silly but is that way to get around a specific rendering issue in Opera Mini which needs to be supported because our project needs to support basically everything because it is a required governmental service.

This code is dealing with an issue in Safari that is supposed to be fixed by June 2024 release - please check if it is still an issue - test by doing the following...

Tldr: No, you can not always make your code self-explanatory.

I enjoy commenting the code if it needs it