Documentation Community Team Meeting (June 2023)

• Date: 2023-06-05

• Time: 19:00 UTC

• This HackMD: https://hackmd.io/@encukou/pydocswg1

• Discourse thread (for June)

• Meeting reports (the latest one might be an unmerged PR)

• Calendar event: (send your e-mail to Mariatta for an invitation)

• How to participate:

  • Go to Google Meet and ask to be let in.

  • To edit notes, click the “pencil” or “split view” button on the HackMD document. You need to log in (e.g. with a GitHub account).

By participating in this meeting, you are agreeing to abide by and uphold the PSF Code of Conduct. Please take a second to read through it!

Roll call

(Name / @GitHubUsername / Discord if different)

• Petr Viktorin / @encukou

• Manuel Kaufmann / @humitos

• Ege Akman / @egeakman

• Daniele / @DanieleProcida

• Ned / @nedbat

• Yaa / @YaaNuamah

• CAM / @CAM-Gerlach (everywhere)

• Hugo / @hugovk

• Bradley

• Marcus / @betteridiot

Regrets:

• Jim DeLaHunt / @JDLH (Sorry, I have no deliverables to report to the group, and I am busy with another project this month.)

• Mariatta

Reports and celebrations

• CAM and Erlend’s PyCon US talk is now up

  • CAM also pressented a derived version at his local Huntsville Python Users Group (HSV.py)

• PEPs site updated for better readability and performance: python/peps#3132

Discussion

• PSF elections: do 5h/month for Python? Self-certify/re-self-certify to vote

  • Re-do the certification for this year!

• Infra: stats for docs

  • Demo

  • Dashboard

  • Script in header: hugovk/cpython#28b2355

  • More info

• Dark theme is live on 3.12 and 3.13, should we deploy it to earlier releases?

  • python/python-docs-theme#44 (comment)

• EuroPython documentation sprint:

  • Would it be a “good fit” for a sprint?

  • How can we organize it?

    • Hugo will organize

  • Who will be there from the docs community?

  • Would a translation sprint be feasible?

• Japanese translation

• How to get started?

  • Find a shortcoming & open an issue for it

  • Find an open issue & ask for help:

    • Docs community issues

    • Python issues

• Adding “how to teach this” section to PEPs

  • we don’t update final PEPs

  • but, you can find the living docs (or create them) and improve that

• Daniele @ EuroPython

  • a workshop on docs organization at EuroPython

  • half hour of hacking on docs while people watch

Next meeting

The docs team generally meets on the first Monday of every month.

We have a recurring Google Calendar event for the meeting. Let Mariatta know your email address and she can invite you.