PEP: Procedure for Adding New Modules (please comment)

David Goodger dgoodger at bigfoot.com
Wed Jul 4 23:32:56 EDT 2001


Martijn: Good PEP. Comments:

> The library PEP
> differs from a normal standard track PEP in that the reference
> implementation should in this case always already have been
> written before the PEP is to be reviewed; the reference
> implementation _is_ the proposed contribution.

By "to be reviewed" do you mean "to be decided upon by the Integrators"? Or
"to be released to the Python community for comment"? I hope the former.
Please clarify.

> In the case where no head maintainer can be found (possibly
> because there are no maintainers left), the integrators will issue
> a call to the community at large asking for new maintainers to
> step forward. If no one does, the integrators can decide to
> declare the contribution deprecated as described in PEP 4.

I agree with Roman that this needs some explanation. When, why, under what
conditions, would the Integrators deprecate a contribution? I think
"maintainerless" is a useful category; after all, most modules do *not*
require much if any maintenance between releases.

> Should there be a list of what criteria integrators use for
> evaluating contributions?

It would be useful. I think it would have to come from the PythonLabs crew
themselves. I think it would be useful to them as well.

> A related question is integration with the Python documentation
> process. Contributions should come with good documentation that
> can be integrated with the Standard Library documentation. Should
> we detail this more in this PEP?

Say exactly that, with a pointer to the "Documenting Python" section of the
Python reference.

-- 
David Goodger    dgoodger at bigfoot.com    Open-source projects:
 - Python Docstring Processing System: http://docstring.sf.net
 - reStructuredText: http://structuredtext.sf.net
 - The Go Tools Project: http://gotools.sf.net




More information about the Python-list mailing list