Documentation Community Team Meeting (November 7, 2023)¶

Roll call¶

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

PEP 732 “The Python Documentation Editorial Board” draft has been published:
- Discourse thread
- Establishes the docs Editorial Board, and the relationship to the docs community
- The idea is that the board can make larger, far-reaching decisions than just people sending PRs
- Joanna is the author, she used to work at Real Python
- How do you join the group? A. It’s a small group with appointed members, not like this community.
- How exactly the decisions will be made is still to be worked out.
- This (docs community) is called the “working group”
[Petr] Issues from the docs@python.org were converted to a list in a GitHub issue

[Petr] Railroad diagrams
- Next stream: youtube.com/live/vHn4YqzYlPo
- A free REPL for learning
[Ege] Looking for help on python-docs-bootstrapper
- Need help with:
  - packaging (done thanks to Hugo)
  - CLI enhancements and features
- If you have some spare time and nothing else to do, feel free to contribute!
[Adam/Ege/Hugo] Frequency of docs.python.org builds
- We used to build all translations & versions
  - Now we only build those that have changed, which reduces the build time.
  - There is still room for improvement: python/docsbuild-scripts#171 (comment)
[Ege/Hugo/CAM] Analytics (Plausible) - CAM sent an e-mail (around late October), no reply yet
[Usman] As a beginner, what’s a good starting point?
- There are some “easy” issues, although they can occasionally not be actually-easy.
- Interested in documentation, look at diataxis and make changes?
  - Diataxis is kind of abstract for newcomers.