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