[Twisted-Python] Docs

Juergen Hermann j.her at t-online.de
Wed May 2 16:18:34 EDT 2001


Glyph asked for the standard rant about using XML:

 - you can use the same set of source files to generate quite different
outputs (html, rdf, latex, paper, pdf, etc.), and the tools for this
come for free (linux, fbsd, etc. doco projects all use docbook)

 - you can have differing styles with the same output medium, compare
t
URLs:

	http://4suite.org/documents/4Suite/TODO

	http://twistedmatrix.com/users/jh.twistd/python/moin.cgi/DocBook
Test

 - docbook is a STANDARD way for SEMANTIC computer manual markup, i.e.
what you have to learn you can use elsewhere, including your resumé

 - all tools are available for python (guess what the above tw url is
generated with)

'nuf said.






More information about the Twisted-Python mailing list