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/2002-April/022247.html below:

[Python-Dev] PEP 287: reStructuredText Standard Docstring Format

[Python-Dev] PEP 287: reStructuredText Standard Docstring Format [Python-Dev] PEP 287: reStructuredText Standard Docstring FormatGuido van Rossum guido@python.org
Wed, 03 Apr 2002 20:01:53 -0500
> Why does the community need a new structured text design? What is
> wrong with existing markup methodologies? The PEP didn't answer these
> with any cogent examples, IMHO.

Maybe that's because it's obvious to anyone who has hung out on
doc-sig long enough.  Structured text is really a great idea for
certain situations; reST is a much better implementation of the idea
than any versions I've seen before.  E.g. the ST code in Zope stinks
(this is not a secret).

> The only rationale that I saw was existing use: the people that
> already make use of it find it natural, and everyone else has to learn
> it.

Maybe David needs to write up the rationale better.  But I can assure
you there is one.

--Guido van Rossum (home page: http://www.python.org/~guido/)




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