Is there a reference or schema description for maxref.xml files?

I am working on a very promising package that embeds Afterglow, my new open-source live-coding environment for creating light shows, to run within Max, and I want it to include excellent documentation when I post it to the tools section here. I have, through trial and error, figured out the basics of creating .maxhelp patches and .maxref.xml reference pages, but I am wondering if there is an explanation of all the things that you can put in the latter somewhere? Or is my best bet to just keep finding examples and stealing things from them?

As a side question, is there documentation about how to override the viewsource method anywhere? The default one that mxj provides is useless in my case, because byte-decompiled class files created by the Clojure compiler are utterly cryptic. I would like to be able to tell it how to find the Clojure source and display that instead.

Thanks for any help you can offer!