PEPs link gone from the Python homepage?

David Abrahams dave at boost-consulting.com
Fri Sep 26 13:59:59 EDT 2003


Skip Montanaro <skip at pobox.com> writes:

>  
>     >> If you find stuff in PEPs you believe belongs in the standard
>     >> documentation set, please file a documentation bug report.
>
>     Dave> Oof.  MRO, descriptors, most of PEPs 252 and 253 last time I
>     Dave> checked, just off the top of my head.  Do I you really think it
>     Dave> would make a difference to *formally* point out that many elements
>     Dave> of the basic design of the object model aren't in the docs?
>
> Yes, it would help.  We have people come to python-dev and ask, "How can I
> help?".  It also serves as a reminder to people who can make the change that
> it needs to be addressed.  Without it, I suspect most of us will forget it
> in the next couple of weeks.
>
>     Dave> And, this is not a rhetorical question: how many bug reports would
>     Dave> be appropriate for all of this information?  Some of these PEPs
>     Dave> cover several topics.
>
> I'd just file one having a subject like "migrate PEP content to
> documentation" to start with.  Assign it to me if you feel the urge.  I'm
> pretty sure Fred's swamped.

Done, and thanks.

>     Dave> Sure, I knew that, but while the docs are still incomplete, you
>     Dave> use what you can, and it would be nice to be sure that the
>     Dave> information was readily accessible.
>
> It's still readily accessible, but it's hard to see that "PEPs" should rank
> up there on the front page with more general concepts like "Documentation"
> or "Developers".  Front page real estate is always at a premium.  I think
> it's appropriate that they are referred as they are now.

Yeah, but after the front page I looked under "Documentation" and
didn't find it either.

> On matters such as this, I don't even bother with the website.  My browser
> home page is a bunch (17) of popup menus laid out in a tabular format and a
> few <form>s.  It has two Python-related menus:
>
>     Python                           Python Docs          
>     ------                           -----------                 
>     Python Home Page                 Module Index        
>     Python VM Wiki                   Python PEPs                 
>     Python @ SF                      Python Wiki                 
>     Python Glossary                  Python HOWTOs       
>     Python-Mode @ SF                 C/C++ API           
>     CSV mailing list                 Library Reference   
>     ALF @ SF                         Language Reference  
>     Watch @ SF                       Spambayes archives  
>     Psyco @ SF                       Python-dev archives         
>     Parnassus                        Python-list archives 
>     Skip's Python Bits               Python-help archives 
>
> That way I always know where to get at the stuff I'm interested in and am
> insulated from changes to the link properties of web pages not completely
> under my control.

Setting up infrastructure takes time, though.  That's what sucks about
computers: you gotta spend time to save time :(

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






More information about the Python-list mailing list