Documentation in RelaxNG
Document Actions
In doing my part to help out with the CNXML 0.6 spec, I have been digging in to RelaxNG. Specifically, I've been reading Eric Van der Vlist's RelaxNG to get a good grip on what you can do with RelaxNG. Chapter 13 in particular proved to be the most helpful in my particular endeavor. I looked up some other sources of information, but really that chapter pretty much covered it.
Honestly, inserting documentation is simple: just add the namespace in question, then use the documentation tag within each define tag, generally as the first element. You can also document references within the define tag, but in the meeting yesterday, Chuck seemed to think this unnecessary. We don't want to documentation everything 15 times!
As a follow-up to this research, I'm going to explore how to pull this documentation from the schema into the actual spec. My handle on XSLT is still a bit shaky, and since XSLT is a big part of my current tasks, working from the ground up will hopefully prove educational and improve my confidence.
