Documentation Community Team Meeting (October 3, 2023)

Roll call

(Name / @GitHubUsername [/ Discord, if different])

• Hugo van Kemenade / @hugovk

• Petr Viktorin / @encukou

• Ned Batchelder / @nedbat

• Daniele Procida / @evildmp

• Mariatta / @mariatta

• Marcus Sherman / @betteridiot

• Adam T / @AA-Turner

• Ryan Duve / @ryan-duve

• CAM Gerlach / @CAM-Gerlach

• Ege Akman / @egeakman

• Carol Willing / @willingc / carolwilling

Reports and celebrations

• Python 3.12.0 has been released:

  • Python 3.12.0 (final) is here

  • Python Release Python 3.12.0 | Python.org

  • What’s New In Python 3.12 — Python 3.12.0 documentation

• [Hugo] python-docs-theme:

  • python-docs-theme 2023.8 has been released

  • Releasing via Trusted Publishers has been set up on PyPI: python/python-docs-theme#148

• [Adam] Editorial work on What’s New in Python 3.12

• [Adam] Work on improving Sphinx’s documentation:

  • New pages for the first-party Domains

  • Improved documentation for make-mode

  • A quick reference for the most common builders

• [Adam] Almost every reference to Distutils has been removed or replaced in Python 3.12’s documentation. Though some remain!

• [Mariatta] PEP Talk video at North Bay Python + this Saturday at PyGotham

• [CAM] Free Google online technical/docs writing workshops, first one tomorrow at 16:30 UTC; thanks Hugo for sharing it! Offline bit short but useful, and online sounds very hands on and interactive learning, which should be fun. CAM will be there and hopes you will too.

• [Petr] Thanks Hugo for the announcement, Ege for the PR and Adam for cleaning the HackMD pad!

Discussion

• [Adam] Frequency of rebuilds of docs.python.org/3/: python/docsbuild-scripts#163

  • Is it OK for the PDFs to lag behind the HTML pages?

  • We could build English HTML every 4-6 hours but translations & PDFs only daily.

  • We don’t know how long the build takes.

  • Could we move to Read the Docs?

  • Perhaps redirect 404s for archives that aren’t build yet to earlier versions: could https://docs.python.org/3.11/archives/python-3.11.999-docs-pdf-letter.zip serve HTML that explains things and links to https://docs.python.org/3.11/archives/ ?

  • Action: Adam to write up something & ask Julien.

• [Hugo] Adopting opengraph preview images for d.p.o: python/docsbuild-scripts#147

• [Adam] Shutting down docs@python.org

  • Action: Petr to think about / redirect posts to GH Issues.

• [Mariatta/Joanna/Ned] PEP for Python Editorial Board

• [Ege] What is the status of “analysing docs.python.org using Google Search Console”?

  • Would have been nice to have, but doesn’t look feasible for now. Hopefully, it will be discussed along with Plausible hosting.

  • We can look into alternatives, such as Google LightHouse.

• [Ege/Hugo/Maciej/CAM] Plausible & Weblate hosting updates (response from the PSF?)

  • [CAM] Emailed Deb a couple weeks ago with the summary of our consensus on the last meeting, but still waiting (again :( ) on a reply.