# Documentation Community Team Meeting (March 6, 2023)


## Roll call

(Name / `@GitHubUsername`)

- Petr Viktorin / `@encukou`
- Ezio Melotti / `@ezio-melotti`
- Ege Akman / `@egeakman`
- C.A.M. Gerlach / `@CAM-Gerlach`
- Ryan Duve / `@ryan-duve`
- Paul Hoffman / `@paulehoffman`
- Hugo van Kemenade / `@hugovk`
- Pradyun Gedam / `@pradyunsg`


## Reports and celebrations

> 60 second updates on things you have been up to, questions you have, or developments you think people should know about. Please add yourself, and if you do not have an update to share, you can pass.

> This is a place to make announcements (without a need for discussion). This is also a great place to give shout-outs to contributors! We'll read through these at the beginning of the meeting.

* Hugo: Automatically edit PRs with link to RTD preview
  * [python/devguide#1061](https://github.com/python/devguide/pull/1061)
  * [python/docs-community#74](https://github.com/python/docs-community/pull/74)
  * [python/peps#3031](https://github.com/python/peps/pull/3031)
  * TODO: Hugo to clean up the Netlify action so we can transfer to the [Python org](https://github.com/python)

* Hugo: Append a hash `?digest` to CSS files for cache-busting
  * [python/devguide#1054](https://github.com/python/devguide/pull/1054)
  * [python/python-docs-theme#108](https://github.com/python/python-docs-theme/pull/108)


## Discussion

* Netlify previews


### 'Internal' items

*For and about the Community or Working Group*

- Overhaul Building the Documentation section for clarity
  - [python/devguide#1038](https://github.com/python/devguide/pull/1038)
  - merged

- [python/devguide#1020](https://github.com/python/devguide/issues/1020): Function signatures in docs (positional-only markers, defaults, `[]` syntax)
  - How discoverable is the `[]` syntax to today's devs?


### Python Project Documentation

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

* Dark theme for docs.python.org
  * (Hugo) PR looks ready to merge: [python/python-docs-theme#44](https://github.com/python/python-docs-theme/pull/44#pullrequestreview-1314475876)
  * [Preview](https://python-docs-theme-previews--44.org.readthedocs.build/en/44/)
  * TODO: Hugo open an issue to ask for a release with pending bugfixes, followed by another with dark theme for easy rollback if needed

* [Lutra](https://pradyunsg.me/lutra/)! Improving the bus factor, accessibility and next steps?

* Move [PEP 636 (Structural Pattern Matching: Tutorial)](https://peps.python.org/pep-0636/#composing-patterns) to main docs
  * See [Discourse thread](https://discuss.python.org/t/is-there-a-good-writeup-talk-about-the-implementation-of-pep-634/21987/6)

* [`concurrent.futures`](https://docs.python.org/3.12/library/concurrent.futures.html) reorganization
  * See [Diataxis website](https://diataxis.fr/) and [Diataxis workshop videos](https://discuss.python.org/t/recordings-available-for-python-docs-diataxis-workshop/19518) for more information on organization

* Sphinx warnings on CI: [hugovk/cpython#43](https://github.com/hugovk/cpython/pull/43)
  * Build on Petr's [python/cpython#21](https://github.com/encukou/cpython/pull/21)
  * 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
  * TODO: Hugo to PR this upstream


### PEP Workflow

* Final PEPs and the canonical docs banner link: in PR [python/peps#2992](https://github.com/python/peps/pull/2992)
* [PEP 1 rewrite?](https://discuss.python.org/t/21068/26)
* Status for PEP 659 and other obsolete PEPs?