Notice how they document how to do things with attributes, annotations, XML, and YAML? Why don’t you do that too? Everything that can be done programmatically should be documented. If it can also be done with CIF XML that should also be documented.
I’ve went ahead sent on your request to our list of docs to be written by Engineering.
If you find any docs in the mean time that need improvement click on the little thumbs down or thumbs up. We look at that and prioritize documentation updates.