[XML-SIG] PyTREX as xml.schema.trex?

[Fred L. Drake, Jr.]

James Tauber writes:
 > Hints on how best to whip up some documentation? I would only need to write
 > up a single page saying how to invoke the validator and intepret the return
 > object.

  My recommendation is to use the Python LaTeX format.  Not because I
think it's a good format (though I don't think it's particularly bad),
but because it will be easy to integrate with other parts of the
Python documentation.
  I'm starting to move once more on turning all the documentation into
an XML format for authoring, and there will be a tool to convert the
Python LaTeX markup into XML with very little manual intervention.
I'm also starting to actually learn XSLT so I can start making use of
an XML version of the docs.  So there is hope.
  Regarding PyXML documentation, what I'd like to do is to create two
documents (based in part on the existing documentation in PyXML and
the Python Library Reference).  The first document (ok, probably a set
of smaller docs) will give the Python bindings of common XML APIs:
DOM, SAX2, etc.  The second will be reference documentation for
utility modules and implementation-specific extensions of the standard
APIs.  The tutorial HOWTO will remain a separate document.


  -Fred

-- 
Fred L. Drake, Jr.  <fdrake at acm.org>
PythonLabs at Digital Creations