Quote:
Originally Posted by ZedMan
Jeebus, assembly. I will never forget that feeling of looking at code I had written only the day before and having NO IDEA what it did anymore 
That said, higher level languages like C# and Java can be much more self documenting through the use of well chosen variable, function and parameter names.
Transitioning between Java and C# is pretty painless. With the exception of library class names, simpler programs will look pretty similar between the two. |
As nice as self documenting code is, it still lacks the complete clarity of inline comments. You don't have to document every single line, but if there is any decision being made, something that might be in any way unclear, tell someone about it.
I once read a quote that said something along the lines of: "Document your code as if the next guy who has to support what you've written is a homicidal maniac, and he knows where you live"