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.

Thomas Owens answers (96 votes): I've seen this done before, both manually by authors and automatically by scripts and triggers integrated with version control systems to add author, check-in comment, ...