Docco
Literate Programming can be Quick and Dirty
Docco is a documentation generator by Jeremy Ashkenas that embraces the literate-programming style: it takes your source code and produces annotated HTML documentation that shows your comments side-by-side with your code. The idea is to read code like a book — commentary on one side, code on the other — which helps reviewers and learners understand intent and implementation simultaneously. It supports many languages (via configuration) and is intentionally quick and dirty, prioritizing lightweight output rather than heavy tooling. For teams that favour documentation that stays close to the codebase (rather than entirely separate docs), Docco offers a pragmatic route to keep documentation aligned with implementation. ...