We all know that writing good code is important and refactoring forces us to think about making methods smaller, more reusable and self-documenting. Some people say that comments are bad and that self-commenting code is what we should strive for.
Despite what you’ll hear though, the code isn’t the documentation. The code tells *a* story, but it doesn't tell the whole story. Join Simon Brown to find out what’s missing and how to create lightweight documentation for your software projects.
Source: http://skillsmatter.com/podcast/open-source-dot-net/code-whole-story
0 reacties:
Post a Comment