[Python-Dev] The docs, reloaded
barry at python.org
Mon May 21 21:29:41 CEST 2007
-----BEGIN PGP SIGNED MESSAGE-----
On May 21, 2007, at 12:28 AM, Martin v. Löwis wrote:
> I disagree. The documentation infrastructure of Python should only
> consider the needs of Python itself. If other people can use that
> infrastructure for other purposes, fine - if they find that it does
> not meet their needs, they have to look elsewhere.
I would take a fairly broad view of the term "for Python" though.
Specifically, third party modules and applications written for and in
Python should be explicitly supported. I think we'd like to see one
(preferred) documentation tool chain for core Python, plus the vast
number of third party modules and apps. I don't see any reason why
Georg's reST-based system couldn't provide that (80/20 rule perhaps?).
I'd point to for example the howto templates, which can be easily
used for third party applications. Mailman uses howtos for example.
BTW, Georg excellent work. I'm a big latex fan and long-time user,
but I do think that using reST will open the door to a lot more
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.7 (Darwin)
-----END PGP SIGNATURE-----
More information about the Python-Dev