Programming statements that can be easily understood by another programmer or even by the original author. Some languages are inherently more self-documenting than others. For example, to the novice, ...

The problem with documenting code is that if you do it too early, it's just another thing to keep updated along with the code. And if you wait until the end, then you have no time or inclination to ...

Documenting your code is a critical part of development, but too many developers pay too little attention to proper commenting. C++ devs have a tool that can help. Javadoc is a standard tool that ...

Doxygen can be an amazing tool for disciplined embedded software developers seeking to quickly generate a software manual that stays in sync with their code. It scans your code, parses out developer ...

A monthly overview of things you need to know as an architect or aspiring architect. Unlock the full InfoQ experience by logging in! Stay updated with your favorite authors and topics, engage with ...

The problem with documenting code is that if you do it too early, it's just another thing to keep updated along with the code. And if you wait until the end, then you have no time or inclination to ...

A reader recently wrote asking if it's OK to skip commenting functions that are “obvious.” He gave the example: I struggled to find any ambiguity in this definition and failed. It's pretty darn clear ...