Merge remote-tracking branch 'upstream/main' into log-update

Author: hugovk

conf.py

@@ -1,3 +1,5 @@
+import json
+
 extensions = [
     'notfound.extension',
     'sphinx.ext.extlinks',
@@ -109,12 +111,21 @@
     # Advanced Tools was renamed Development Tools in gh-1149
     "advanced-tools/clang.rst": "development-tools/clang.rst",
     "advanced-tools/gdb.rst": "development-tools/gdb.rst",
-    # Core Developers
-    "coredev.rst": "core-developers/become-core-developer.rst",
-    "committing.rst": "core-developers/committing.rst",
-    "developers.rst": "core-developers/developer-log.rst",
-    "experts.rst": "core-developers/experts.rst",
-    "motivations.rst": "core-developers/motivations.rst",
+    # Core team
+    "coredev.rst": "core-team/join-team.rst",
+    "committing.rst": "core-team/committing.rst",
+    "developers.rst": "core-team/team-log.rst",
+    "experts.rst": "core-team/experts.rst",
+    "motivations.rst": "core-team/motivations.rst",
+    # core-developers/ -> core-team/
+    "core-developers/become-core-developer.rst": "core-team/join-team.rst",
+    "core-developers/committing.rst": "core-team/committing.rst",
+    "core-developers/developer-log.rst": "core-team/team-log.rst",
+    "core-developers/experts.rst": "core-team/experts.rst",
+    "core-developers/index.rst": "core-team/index.rst",
+    "core-developers/memorialization.rst": "core-team/memorialization.rst",
+    "core-developers/motivations.rst": "core-team/motivations.rst",
+    "core-developers/responsibilities.rst": "core-team/responsibilities.rst",
     # Developer Workflow
     "c-api.rst": "developer-workflow/c-api.rst",
     "communication.rst": "developer-workflow/communication-channels.rst",
@@ -165,8 +176,17 @@
 # sphinx-notfound-page
 notfound_urls_prefix = "/"
 
+# Dynamically expose the Python version associated with the "main" branch.
+# Exactly one entry in ``release-cycle.json`` should have ``"branch": "main"``.
+with open("include/release-cycle.json", encoding="UTF-8") as _f:
+    _cycle = json.load(_f)
+
+_main_version = next(
+    version for version, data in _cycle.items() if data.get("branch") == "main"
+)
+
 # prolog and epilogs
-rst_prolog = """
+rst_prolog = f"""
 .. |draft| replace::
     This is part of a **Draft** of the Python Contributor's Guide.
     Text in square brackets are notes about content to fill in.
@@ -183,6 +203,8 @@
 
 .. _Refactoring the DevGuide: https://discuss.python.org/t/refactoring-the-devguide-into-a-contribution-guide/63409
 
+.. |main_version| replace:: {_main_version}
+
 """
 
 # sphinx.ext.extlinks

contrib/core-team/committing.rst

@@ -8,4 +8,4 @@
 [This is the existing core developers :ref:`committing` page from the devguide.  We'll
 adjust "core developer" to "core team" where appropriate.]
 
-.. include:: ../../core-developers/committing.rst
+.. include:: ../../core-team/committing.rst

contrib/core-team/developer-log.rst

@@ -8,4 +8,4 @@
 [This is the existing core developers :ref:`experts` page from the devguide.  We'll
 adjust "core developer" to "core team" where appropriate.]
 
-.. include:: ../../core-developers/experts.rst
+.. include:: ../../core-team/experts.rst

contrib/core-team/experts.rst

@@ -5,13 +5,13 @@
    |purpose|
 
 
-.. _c_coreteam:
+.. _c_core-team:
 
 =========
 Core team
 =========
 
-[This is mostly re-organized from the :ref:`core-dev` section of the devguide,
+[This is mostly re-organized from the :ref:`core-team` section of the devguide,
 but with "core developer" language changed to "core team" where possible.]
 
 .. toctree::
@@ -20,6 +20,6 @@ but with "core developer" language changed to "core team" where possible.]
    responsibilities
    committing
    experts
-   developer-log
+   team-log
    motivations
    join-team

contrib/core-team/index.rst

@@ -5,12 +5,7 @@
    |purpose|
 
 
-[This is the existing core developers :ref:`become-core-developer` page from the devguide with the title changed.  We'll
+[This is the existing core developers :ref:`join-core-team` page from the devguide.  We'll
 adjust "core developer" to "core team" where appropriate.]
 
-=========================
-How to join the core team
-=========================
-
-.. include:: ../../core-developers/become-core-developer.rst
-   :start-line: 7
+.. include:: ../../core-team/join-team.rst

contrib/core-team/join-team.rst

@@ -8,4 +8,4 @@
 [This is the existing core developers :ref:`motivations` page from the devguide.  We'll
 adjust "core developer" to "core team" where appropriate.]
 
-.. include:: ../../core-developers/motivations.rst
+.. include:: ../../core-team/motivations.rst

contrib/core-team/motivations.rst

@@ -8,4 +8,4 @@
 [This is the existing core developers :ref:`responsibilities` page from the devguide.  We'll
 adjust "core developer" to "core team" where appropriate.]
 
-.. include:: ../../core-developers/responsibilities.rst
+.. include:: ../../core-team/responsibilities.rst

contrib/core-team/responsibilities.rst

@@ -0,0 +1,11 @@
+.. important::
+
+   |draft|
+
+   |purpose|
+
+
+[This is the existing core team :ref:`team-log` page from the devguide.  We'll
+adjust "core developer" to "core team" where appropriate.]
+
+.. include:: ../../core-team/team-log.rst

contrib/core-team/team-log.rst

@@ -75,7 +75,7 @@ major section at the top of each column.]*
        * :ref:`documenting`
        * :ref:`style-guide`
        * :ref:`rst-primer`
-       * :ref:`translating`
+       * :doc:`documentation/translations`
        * :ref:`devguide`
      -
        * :ref:`setup`
@@ -95,7 +95,7 @@ major section at the top of each column.]*
        * :ref:`gh-faq`
        * :ref:`triage-team`
 
-Core team members will find guidance in the :ref:`c_coreteam` section.
+Core team members will find guidance in the :ref:`c_core-team` section.
 
 Contents
 ========