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