Python has recently taken the second spot among popular programming languages because it is free and easy to learn and use. This article lists 3 ways Python can be useful in the documentation process. Includes links to code samples.
How to make every word worth the effort.
If documentation does not add value or information that cannot be gleaned from code, then it is pretty much vacuous.
How to evaluate your code documentation?
Besides being comprehensible, documentation has to make explicit what is not to the reader.