Adding a "packaging flow overview" to the PyPA docs

Packaging
8

By C.A.M. Gerlach via Discussions on Python.org at 28Jun2022 23:45:

I definitely second the concern about the confusion between import
packages and distribution packages, given these are distinct concepts
that routinely confuse users who conflate them, but are certainly not
the same, as discussed in e.g. this recent
thread.
I haven’t reviewed it in detail, but the guide should at minimum make
this distinction this upfront with a link to the glossary definition,
and then preferably repeat and/or link the full term whenever needed,
and make special note when an import package is discussed to always
refer to it as such, with a link to the glossary.

Wait, huh? Where does it do that? The definition of a distribution package states they are

Gah.

I conflated it with the paragraph about a “Built Distribution” directly
above. I think I just let my eyes drift. So I’ll put back my diff using
@sinoroc’s suggestion.

It now reads:

The document aims to outline the flow involved in publishing/distributing
a `distribution package`_, usually to the `Python Package Index (PyPI)`_.

.. _distribution package: 
https://packaging.python.org/en/latest/glossary/#term-Distribution-Package
.. _Python Package Index (PyPI): https://pypi.org/

Cheers,
Cameron Simpson cs@cskk.id.au

2 Likes