|
| 1 | +# Documentation Community Team Meeting (November 2023) |
| 2 | + |
| 3 | +- **Date:** 2023-11-07 |
| 4 | +- **Time:** [20:00 UTC](https://arewemeetingyet.com/UTC/2023-11-07/20:00/Docs%20Meeting) |
| 5 | +- **This HackMD:** https://hackmd.io/@encukou/pydocswg1 |
| 6 | +- [**Discourse thread**](https://discuss.python.org/t/documentation-community-meeting-november-7-2023/38032) (for November) |
| 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 | +- Marcus Sherman / `@betteridiot` |
| 21 | +- Petr Viktorin / `@encukou` |
| 22 | +- Ned Batchelder / `@nedbat` |
| 23 | +- Ege Akman / `@egeakman` |
| 24 | +- Ezio Melotti / `@ezio-melotti` |
| 25 | +- Hugo van Kemenade / `@hugovk` |
| 26 | +- Usman Akinyemi / `@Unique_Usman` |
| 27 | +- Blaise Pabon / `@blaisep` / `BlaisePabon` |
| 28 | +- Ryan Duve / `@ryan-duve` |
| 29 | +- Pradyun Gedam / `@pradyunsg` |
| 30 | + |
| 31 | + |
| 32 | +## Reports and celebrations |
| 33 | + |
| 34 | +- [PEP 732](https://peps.python.org/pep-0732/) "The Python Documentation Editorial Board" draft has been published: |
| 35 | + - [Discourse thread](https://discuss.python.org/t/pep-732-the-python-documentation-editorial-board/36710) |
| 36 | + - Establishes the docs Editorial Board, and the relationship to the docs community |
| 37 | + - The idea is that the board can make larger, far-reaching decisions than just people sending PRs |
| 38 | + - Joanna is the author, she used to work at Real Python |
| 39 | + - How do you join the group? A. It's a small group with appointed members, not like this community. |
| 40 | + - How exactly the decisions will be made is still to be worked out. |
| 41 | + - This (docs community) is called the "working group" |
| 42 | + |
| 43 | +- [Petr ] Issues from the [email protected] were converted to [a list in a GitHub issue ](https://github.com/python/cpython/issues/110383) |
| 44 | + |
| 45 | + |
| 46 | +## Discussion |
| 47 | + |
| 48 | +- [Petr] [Railroad diagrams](https://discuss.python.org/t/36709/20) |
| 49 | + - Next stream: https://youtube.com/live/vHn4YqzYlPo |
| 50 | + - [A free REPL for learning](https://tabatkins.github.io/railroad-diagrams/generator.html#Diagram) |
| 51 | + |
| 52 | +- [Ege] Looking for help on [python-docs-bootstrapper](https://github.com/egeakman/python-docs-bootstrapper/issues/8) |
| 53 | + - Need help with: |
| 54 | + - packaging (done thanks to Hugo), |
| 55 | + - CLI enhancements and features |
| 56 | + - If you have some spare time and nothing else to do, feel free to contribute! |
| 57 | + |
| 58 | +- [Adam/Ege/Hugo] Frequency of docs.python.org builds |
| 59 | + - We used to build all translations & versions |
| 60 | + - Now we only build those that have changed, which reduces the build time. |
| 61 | + - There is still room for improvement: [python/docsbuild-scripts#171 (comment)](https://github.com/python/docsbuild-scripts/pull/171#issuecomment-1767764506) |
| 62 | + |
| 63 | +- [Ege/Hugo/CAM] Analytics (Plausible) - CAM sent an e-mail (around late October), no reply yet |
| 64 | + |
| 65 | +- [Usman] As a beginner, what's a good starting point? |
| 66 | + - There are some "easy" issues, although they can occasionally not be actually-easy. |
| 67 | + - Interested in documentation, look at diataxis and make changes? |
| 68 | + - Diataxis is kind of abstract for newcomers. |
| 69 | + |
| 70 | + |
| 71 | +## Next meeting |
| 72 | + |
| 73 | +The docs team generally meets on the first Tuesday of every month around 20:00-ish UTC. |
| 74 | + |
| 75 | +We have a recurring Google Calendar event for the meeting. |
| 76 | +Let Mariatta know your email address and she can invite you. |
0 commit comments