Quote Originally Posted by Joacim Andersson View Post
You mean you want API documentation even though we have inline comments in the source code which you don't have access to? Because these comments are so important, aren't they? Isn't that what this thread is all about?
Exactly my point... EG seemed to indicate that API functions should be so well named along with parameters that we know what each one is that that any further extraneous documentation shouldn't be necessary... and he'd be right if we all had access to all the source code out there... but we don't... so we need that doucmentation at the call level to know what is what.

Beyond that, as for inline comments, the code should be as self-documenting as possible... but it isn't always, and sometimes things can get confusing on just what exactly is going on... so in that case comments are good... but should be as concise and short as possible...

-tg