From "We Are Morons: a quick look at the Win2k source":
Despite the above, the quality of the code is generally excellent. Modules are small, and procedures generally fit on a single screen. The commenting is very detailed about intentions, but doesn't fall into
"add one to i" redundancy.There is some variety in the commenting style. Sometimes blocks use
a at every line, sometimes//
the . In some modules functions have a history, some do not. Some functions describe their variables in a comment block, some don't. Microsoft appears not to have fallen into the trap of enforcing/* */
styleover-rigid standards or universal use ofover-complicated automatic tools. They seem to trust their developers to comment well, and they do.