"document each individual function and assume that that adds up to a complete description." Every major system for converting function documentation to code ha

"document each individual function and assume that that adds up to a complete description." Every major system for converting function documentation to code has a slot for documentation at the top of the module/package/class/whatever. I find this is very underused, almost across the board. I actually quite like automatic documentation, on the provision that you put something decent at the top for people to orient with.