On 17/11/2010 13:21, Fred Drake wrote:
2010/11/17 Michael Foord<fuzzy...@voidspace.org.uk>:
So -1 on splitting Python development style guide into multiple documents.
I don't think that the publicness or API stability promises of the
standard library are part of a style guide. They're an essential part
of the library documentation. They aren't a guide for 3rd-party code,
and are specific to the standard library.
PEP 8 *isn't* targeted at third party code - is the development style
guide for the Python standard library.
This document gives coding conventions for the Python code comprising the
standard library in the main Python distribution.
The ideal place for informing the Python core developers the naming
conventions we should use for our public APIs...
(Which is why Guido said that a style guide *is* the right place for
this information.)
It doesn't mean it shouldn't be information provided to library users as
well. (As discussed.)
All the best,
Michael Foord
If we can't come up with something reasonable for the standard
library, we *certainly* shouldn't be making recommendations on the
matter for 3rd party code. If we do come up with something
reasonable, we can recommend it to others later (once field-proven),
and without duplication. (Possibly by referring to the standard
library documentation, and possibly by refactoring. That's not
important until we have something, though.)
-Fred
--
Fred L. Drake, Jr.<fdrake at acm.org>
"A storm broke loose in my mind." --Albert Einstein
--
http://www.voidspace.org.uk/
READ CAREFULLY. By accepting and reading this email you agree,
on behalf of your employer, to release me from all obligations
and waivers arising from any and all NON-NEGOTIATED agreements,
licenses, terms-of-service, shrinkwrap, clickwrap, browsewrap,
confidentiality, non-disclosure, non-compete and acceptable use
policies (”BOGUS AGREEMENTS”) that I have entered into with your
employer, its partners, licensors, agents and assigns, in
perpetuity, without prejudice to my ongoing rights and privileges.
You further represent that you have the authority to release me
from any BOGUS AGREEMENTS on behalf of your employer.
_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe:
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
