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.
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.
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.
Skip