Automated tests == reference documentation
Someone was asking about ujax:redirect in Sling. We have no docs on that yet, but how about some (readable) automated test code?
Using automated tests as reference documentation means that the docs will always be in sync with the code - assuming you're using continuous integration to run those tests often.
People might object to having to read source code, so maybe creating a filter that presents the code in a nicer way would help?
Literate programming for test cases...the idea sounds worth pursuing.