Last week I wrote about good practices in writing comment headers for source code files. Several readers wrote asking for my thoughts on headers for functions. I recommend reading code. Lots of code.

I read a great deal of code. The vast majority is in C with some C++ and a bit of assembly sprinkled in. Some of it is brilliantly-written, clearly by developers who are craftspeople of the highest ...