Documentation Community Team Meeting (April 3, 2023)¶

Roll call¶

(Name / @GitHubUsername)

Welcome Joanna

Dark theme for docs.python.org now live! Thanks Hugo!
Final PEPs and the canonical docs banner link now merged, thanks Pradyun (and Hugo)!
- See PEP 621 for a live example
Sphinx warnings for nit-picky mode (undefined references) merged!
- show Sphinx warnings in changed files, can’t fail
- show Sphinx warnings in required-list (e.g. What’s New in 3.12), can fail
- Further followups in python/cpython#103116, python/cpython#103135 and python/cpython#103191 all merged!
- blurb PR to avoid spaces in filenames

Netlify preview links are in
Docs Editorial [Board?]
- There’s editorial board (who’s in it, how to get the “authority”)
More feedback, input and questions from Joanna, hopefully!
- what’s blocking people from contributing?
  - time, money
  - is there problem with some part of process
  - CAM: has been productive, but still have time & money constraints
  - lack of direction, authority
  - impostor syndrome, what can we do?
  - Needs organization, we can do something about it
  - Funding: some programs exist like Season of Docs
  - Contributing to docs is considered second class. (It is not here).
- volunteering
  - we can’t tell people what to do, but we can guide and direct them.
potential tasks/issues for PyCon US sprint
- moving PEP 636
who wants to volunteer to be the authority of editorial?

Relating to docs.python.org, peps.python.org, devguide.python.org, etc.

Followups from last month(s)?

Lutra! Improving the bus factor, accessibility and next steps?
Move PEP 636 (Structural Pattern Matching: Tutorial) to main docs
- See Discourse thread
concurrent.futures reorgantization
- See Diataxis website and Diataxis workshop videos for more information on organization