A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://mail.python.org/pipermail/python-dev/2005-December/058965.html below:

[Python-Dev] status of development documentation

[Python-Dev] status of development documentationFredrik Lundh fredrik at pythonware.com
Wed Dec 21 22:40:45 CET 2005
Barry Warsaw wrote:

> Sorry, but HTML and (even more so) XML are not human-writable. :)  Yeah,
> we can all do the simple stuff, but I absolutely hate authoring in HTML,
> and it would be a nightmare if the documentation production system
> didn't handle lots and lots of magic for you (like weaving in the right
> footers, css, etc. -- oh wait, that's ht2html!).

Sure, and some people hate using whitespace for block structure.

> Maybe it's just because I came in late on this thread, but what exactly
> is broken about the current LaTeX documentation?

Checked the python-list archives lately?  If you google c.l.python for the
word "documentation", you'll find recent megathreads with subjects like
"bitching about the documentation", "opensource documentation problems"
and "python documentation should be better" among the top hits.  But if
you check the bug and patch trackers, you don't find many contributions.
Something's definitely broken.

</F>



More information about the Python-Dev mailing list

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