PEPs link gone from the Python homepage?

David Abrahams dave at boost-consulting.com
Fri Sep 26 12:44:41 EDT 2003


Skip Montanaro <skip at pobox.com> writes:

>     David> Since a significant part of Python is only documented in PEPs, I
>     David> am disappointed to see that they can't be easily found.  Where
>     David> are they?
>
> Dave,
>
> Try the left margin of the /dev/ page.  

Thanks.  I was looking for /dev/, too, but I always forget to scan
the top.  Eventually I got there from the search page.
 
> If you find stuff in PEPs you believe belongs in the standard
> documentation set, please file a documentation bug report.

Oof.  MRO, descriptors, most of PEPs 252 and 253 last time I checked,
just off the top of my head.  Do I you really think it would make a
difference to *formally* point out that many elements of the basic
design of the object model aren't in the docs?

And, this is not a rhetorical question: how many bug reports would be
appropriate for all of this information?  Some of these PEPs cover
several topics.

> While PEPs do contain a lot of valuable information, I don't think
> that using them for end-user documentation was a goal.

Sure, I knew that, but while the docs are still incomplete, you use
what you can, and it would be nice to be sure that the information
was readily accessible.

-- 
Dave Abrahams
Boost Consulting
www.boost-consulting.com






More information about the Python-list mailing list