Potjeh wrote:Your code has no comments whatsoever, right?
That's not entirely true, as I tend to comment things that are very unobvious, like weird interactions with the operating system and such things; you'll actually find some of those in the client code as well. But yes, my comments are few and far between. Frankly, though, I do this because I generally consider it a boon to the quality of the code rather than the other way around; I find many projects that use comments simply to describe that which is obvious from looking at the code anyway (when I read the code of such projects, my eyes just filter the comments out as they do with ads on the web), which makes the comments not only superfluous but an active waste of screen-space. As I put it elsewhere, when I read code, I want to read code, not English. I quite dislike, for instance, reading the source code of the standard Java library, where you can see like three small methods on one screen, the rest being consumed by comments which could otherwise have let you see five other methods, which would have made the overview of control flow much greater. Sure, it's possible to make some editors fold comments, but that only compensates for the negative effects anyway.
Then again, I shan't really be too hard on comments; I admit they may be more useful than what I have made of them, at least. It is also true, however, that I never really wrote this code with the intention of anyone else reading it, so with that in mind it would also have been a waste of my time. This purchase did come quite much as a surprise to me. ;)
Comment usage is a different issue than messy code, however.