Add governance contact (#1260)

hugovk · web-flow · commit 90595bcedae9 · 2024-01-30T17:12:56.000+02:00
diff --git a/conf.py b/conf.py
@@ -8,6 +8,7 @@
 extensions = [
     'custom_roles',
     'notfound.extension',
+    'sphinx.ext.extlinks',
     'sphinx.ext.intersphinx',
     'sphinx.ext.todo',
     'sphinx_copybutton',
@@ -170,6 +171,14 @@
 # sphinx-notfound-page
 notfound_urls_prefix = "/"
 
+# sphinx.ext.extlinks
+# This config is a dictionary of external sites,
+# mapping unique short aliases to a base URL and a prefix.
+# https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html
+extlinks = {
+    "github": ("https://github.com/%s/", "%s"),
+}
+
 # sphinxext-opengraph config
 ogp_site_url = "https://devguide.python.org/"
 ogp_site_name = "Python Developer's Guide"
diff --git a/developer-workflow/development-cycle.rst b/developer-workflow/development-cycle.rst
@@ -371,3 +371,35 @@ 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.
+
+Governance
+----------
+
+The Python Steering Council has overall authority over Python and has delegated
+some of its responsibilities to other groups.
+
+This table lists the PEPs defining each group's responsibilities,
+and the repository where you can open an issue to ask for a decision.
+
+.. list-table::
+   :header-rows: 1
+
+   * - Name
+     - PEP
+     - Contact repo
+   * - Steering Council
+     - :pep:`13`
+     - :github:`python/steering-council`
+   * - C API Working Group
+     - :pep:`731`
+     - :github:`capi-workgroup/decisions`
+   * - Documentation Editorial Board
+     - :pep:`732`
+     - :github:`python/editorial-board`
+   * - Typing Council
+     - :pep:`729`
+     - :github:`python/typing-council`
+
+.. seealso::
+
+   All governance PEPs: https://peps.python.org/topic/governance/
