Software Development Resources
Main Page | Software Development | Categories | Recent changes | About DocForge
Log in / create account | Log in with OpenID | Help

Self-documenting code

From DocForge

Self-documenting code is the concept that code in many programming languages can be written in such a way that a human can easily understand exactly what it's doing without added code documentation or code comments.

Ideally all code should be self-documenting, but this is an ideal rarely achieved. As projects grow, coded logic becomes dispersed and harder to follow. Occasionally shorthand coding techniques are used for simplicity or performance, but their overuse can cause confusion when unfamiliar with the code.

Discussion

comments powered by Disqus