Optimizing Code For Reading

Juergen Brendel’s advice about read-optimizing your code is useful. Developers’ love-hate relationship with documentation spans a wide spectrum. You will meet developers who look at commenting as an effect of poor programming and also those who think that all code should be documented. Factors that I use to decide the level of documentation are the domain and the audience for my code. In-line comments can be effectively used for things that cannot be conveyed by code at times – the rationale behind design decisions and the problem the code is trying to solve.

Say your thought!

If you want to use HTML you can use these tags: <a>, <em>, <strong>, <abbr>, <code>, <blockquote>. Closing the tags will be appreciated as this site uses valid XHTML.



Abhijit Nadgouda
iface Consulting
+91 9819820312
My bookmarks


This is the weblog of Abhijit Nadgouda where he writes down his thoughts on software development and related topics. You are invited to subscribe to the feed to stay updated or check out more subscription options. Or you can choose to browse by one of the topics.