Now, this is a great counter-rant, replying to one of my more popular articles: https://blog.jooq.org/the-golden-rules-of-code-documentation/ The counter-rant is given here: http://javax0.wordpress.com/2013/04/07/to-comment-or-not-to-comment-that-is-the-question The writer went through the trouble of actually implementing my fictional (but not unrealistic) example, which he's publicly displaying on GitHub: https://github.com/verhas/commentOrNotToComment (my fork, if the former was deleted) The code still doesn't communicate … Continue reading A Great Counter-Rant
Tag: documentation
The Golden Rules of Code Documentation
Here's another topic that is highly subjective, that leads to heated discussions, to religious wars and yet, there's no objective right or wrong. A previous post on my blog was reblogged to my blogging partner JavaCodeGeeks. The amount of polarised ranting this blog provoked on JCG is hilarious. Specifically, I like the fact that people … Continue reading The Golden Rules of Code Documentation