[issue14899] Naming conventions and guidelines for packages and namespace packages

[Benoît Bryon]

New submission from Benoît Bryon <benoit at marmelune.net>:

Scope:

* Python documentation lacks conventions, or at least guidelines,
  to choose a name for a package.

* Python has tools to create and distribute packages.
  Not covered by this issue.

* Python has tools to create namespace packages.
  Not covered by this issue.

* Python has conventions about "syntax" of module names in PEP 8.
  Not covered by this issue.

Goal: add guidelines+conventions about package names in Doc/packaging/

Discussion started at http://mail.python.org/pipermail/distutils-sig/2012-May/018551.html

Jim Fulton said in http://mail.python.org/pipermail/distutils-sig/2012-May/018553.html:

> +1 for an official document (or addition to an existinhg document)
     providing a rational for namespace packages and their naming

Here is a ticket where proposals can be referenced.

Contributions can be pushed on the "doc-package-naming-conventions" branch of https://bitbucket.org/benoitbryon/cpython

----------
assignee: docs at python
components: Documentation
hgrepos: 128
messages: 161502
nosy: benoitbryon, docs at python
priority: normal
severity: normal
status: open
title: Naming conventions and guidelines for packages and namespace packages
type: enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue14899>
_______________________________________