It seems that the only valid documentation can be found in the Javadoc. Documentation on the wiki seems only UI/User related. What developers are actually looking for is how to use the scheduler via REST or directly.
Document how to schedule a recording
Describe the required DublinCore document
Describe CA properties and how they influence a recording
Document how to update a recording
Document how to delete a recording
Document how to access the resulting iCal feeds and their format