Distinguish user documentation from technical documentation. [Types of Documentation ]
Create standard POD templates for modules and applications. [Boilerplates ]
Extend and customize your standard POD templates. [Extended Boilerplates ]
Put user documentation in source files. [Location ]
Keep all user documentation in a single place within your source file. [Contiguity ]
Place POD as close as possible to the end of the file. [Position ]
Subdivide your technical documentation appropriately. [Technical Documentation ]
Use block templates for major comments. [Comments ]
Use full-line comments to explain the algorithm. [Algorithmic Documentation ]
Use end-of-line comments to point out subtleties and oddities. [Elucidating Documentation ]
Comment anything that has puzzled or tricked you. [Defensive Documentation ]
Consider whether it's better to rewrite than to comment. [Indicative Documentation ]
Use "invisible" POD sections for longer technical discussions. [Discursive Documentation ]
Check the spelling, syntax, and sanity of your documentation. [Proofreading ]