On 5/19/07, Georg Brandl <g.brandl at gmx.net> wrote: > > Hi, > > over the last few weeks I've hacked on a new approach to Python's > documentation. > As Python already has an excellent documentation framework, the docutils, > with a > readable yet extendable markup format, reST, I thought that it should be > possible to use those instead of the current LaTeX->latex2html toolchain. > > For the impatient: the result can be seen at <http://pydoc.gbrandl.de>. I really want this! >From a doc writer's perspective I find this reST approach much easier to grapple than the LaTeX one since I find reST markup nicer for simple things like lists and bolding. From a committer's POV I like this as it should hopefully get more people to help with changes and make it easy for me to build the docs locally to make sure the markup is correct. And from a lazy coder's POV I love it as Georg has already done all the work (and in Python so if I really have to change something I have a better chance of figuring out how). -Brett -------------- next part -------------- An HTML attachment was scrubbed... URL: http://mail.python.org/pipermail/python-dev/attachments/20070519/689c521e/attachment.html
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4