Proper documentation
This is pretty much a work-in-progress hack for Diversity. Be wary of possible API changes.
Document params & return
What is this thing? Used by external calls