>"If the docs differ from the code, I'm left to figure out which is right." That's a good thing! It makes you think about what is actually the truth. If there

>"If the docs differ from the code, I'm left to figure out which is right." That's a good thing! It makes you think about what is actually the truth. If there was only code, you could easily get the wrong assumption silently. You wouldn't be confused, but you would also be wrong..... when the code and documentation doesn't match, you have to expend brainpower to figure out what's going on. This is a good thing, it also helps you learn:)