You can repurpose Docco as a running commentary for library usage or for examples. This combines the readability of Docco with the awesome usefulness of usage examples.

It also allows you to easily run your example code as part of your test suite. Nothing more frustrating than broken example code.

e.g. http://dev.groupdock.com/kin/