> > What are people using to comment and generate documentation > > about relaxng schema?
There is, of course, the TEI Guidelines and its chapter on "Documentation Elements", aka ODDs: http://www.tei-c.org/release/doc/tei-p5-doc/html/TD.html. But the TEI is not about documenting a RELAX NG schema, rather it is about writing an abstract encoding system in such a way that through tangle and weave processes both prose documentation and a formal schema, likely in RELAX NG, can be produced. The major drawback is that there are RELAX NG constructs (like co-constraint) that cannot be expressed in ODD. (The TEI also limits itself to deterministic content models and won't use interleave, but that isn't required by the ODD language, and personally I hope we drop these restrictions soon.)
