|
| 1 | +# Documentation Community Team Meeting (April 2024) |
| 2 | + |
| 3 | +- **Date:** 2024-04-02 |
| 4 | +- **Time:** [19:00 UTC](https://arewemeetingyet.com/UTC/2024-04-02/19:00/Docs%20Meeting) |
| 5 | +- **This HackMD:** https://hackmd.io/@encukou/pydocswg1 |
| 6 | +- [**Discourse thread**](https://discuss.python.org/t/49574) (for April) |
| 7 | +- [**Meeting reports**](https://docs-community.readthedocs.io/en/latest/monthly-meeting/) (the latest one might be an [**unmerged PR**](https://github.com/python/docs-community/pulls)) |
| 8 | +- **Calendar event:** (send your e-mail to Mariatta for an invitation) |
| 9 | +- **How to participate:** |
| 10 | + - Go to [Google Meet](https://meet.google.com/dii-qrzf-wkw) and ask to be let in. |
| 11 | + - To edit notes, click the “pencil” or “split view” button on the [HackMD document](https://hackmd.io/@encukou/pydocswg1). You need to log in (e.g. with a GitHub account). |
| 12 | + |
| 13 | +By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/). |
| 14 | +Please take a second to read through it! |
| 15 | + |
| 16 | + |
| 17 | +## Roll call |
| 18 | + |
| 19 | +(Name / `@GitHubUsername` *[/ Discord, if different]*) |
| 20 | + |
| 21 | +- Petr Viktorin / `@encukou` |
| 22 | +- Hugo van Kemenade / `hugovk` |
| 23 | +- Daniele |
| 24 | +- Carol / `@willingc` |
| 25 | +- Ned / `@nedbat` |
| 26 | +- CAM / `@CAM-Gerlach` |
| 27 | +- Bradley |
| 28 | +- Ashley / `@AWhetter` |
| 29 | + |
| 30 | +## Reports and celebrations |
| 31 | + |
| 32 | +- [Carol] Docs summit at PyCon US https://us.pycon.org/2024/events/hatchery/docs-summit/ |
| 33 | +- [Hugo] Modernised font on macOS: [python/python-docs-theme#176](https://github.com/python/python-docs-theme/pull/176) |
| 34 | +- [Hugo] I wrote up how to activate tabs in Sphinx docs based on the reader's OS: https://dev.to/hugovk/sphinx-docs-how-to-activate-tabs-for-your-os-pd3 |
| 35 | +- [Hugo] Python 3.11 is now only accepting security fixes, so very few docs PRs need backporting: https://devguide.python.org/versions/ |
| 36 | + |
| 37 | +## Discussion |
| 38 | + |
| 39 | +### Changelog splitting/reduction |
| 40 | + |
| 41 | +No use cases other than "grepping it all" found so far. |
| 42 | + |
| 43 | +### [CAM] WarningMessage is undocumented |
| 44 | + |
| 45 | +https://discuss.python.org/t/warningmessage-is-undocumented/48877 |
| 46 | + |
| 47 | +Please read the thread and chime in! |
| 48 | + |
| 49 | +### Parameter annotations: `int | float` or `int or float`? |
| 50 | + |
| 51 | +https://discuss.python.org/t/how-should-we-mark-up-multiple-types-in-a-type-field/48196 |
| 52 | + |
| 53 | +## Next meeting |
| 54 | + |
| 55 | +The docs team generally meets on the first Tuesday of every month around 19:00-ish UTC. |
| 56 | + |
| 57 | +We have a recurring Google Calendar event for the meeting. |
| 58 | +Let Mariatta know your email address and she can invite you. |
0 commit comments