Document the PyPI org policy (python#1484)

hugovk · web-flow · commit 5649d763a0a6 · 2025-01-10T18:53:29.000+01:00
diff --git a/conf.py b/conf.py
@@ -200,6 +200,7 @@
     "github": ("https://github.com/%s", "%s"),
     "github-user": ("https://github.com/%s", "@%s"),
     "pypi": ("https://pypi.org/project/%s/", "%s"),
+    "pypi-org": ("https://pypi.org/org/%s/", "%s"),
 }
 
 # sphinxext-opengraph config
diff --git a/developer-workflow/development-cycle.rst b/developer-workflow/development-cycle.rst
@@ -370,6 +370,30 @@ administrators) to merge changes to that branch.
 Multi-Factor Authentication must be enabled by the user in order to retain
 access as a Release Manager of the branch.
 
+PyPI organization policy
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+The Python core team owns the :pypi-org:`cpython` and :pypi-org:`python`
+organizations on PyPI for publishing packages.
+The main benefits of adding packages to these organizations:
+
+* Visibility: we can see our packages under a PyPI org page
+* Maintainability: we can share granular PyPI access to improve the bus factor
+
+The general policy on which organization to use:
+
+* :pypi-org:`cpython`:
+  for development tools that are tied fairly closely to CPython development.
+  For example, :pypi:`blurb` and :pypi:`cherry-picker`.
+  Users generally shouldn&rsquo;t have to care except for developing CPython itself
+  (although that doesn&rsquo;t mean the tools necessarily have to be unusable for
+  anyone else).
+* :pypi-org:`python`:
+  for general-audience projects that are maintained by the Python core team.
+  For example, :pypi:`pyperformance`, :pypi:`python-docs-theme` and
+  :pypi:`tzdata`.
+
+
 Governance
 ----------
 

Original file line number	Diff line number	Diff line change
`@@ -200,6 +200,7 @@`
`200`	`200`	`"github": ("https://github.com/%s", "%s"),`
`201`	`201`	`"github-user": ("https://github.com/%s", "@%s"),`
`202`	`202`	`"pypi": ("https://pypi.org/project/%s/", "%s"),`
	`203`	`+ "pypi-org": ("https://pypi.org/org/%s/", "%s"),`
`203`	`204`	`}`
`204`	`205`
`205`	`206`	`# sphinxext-opengraph config`