|
| 1 | +# Documentation Community Team Meeting (May 6, 2025) |
| 2 | + |
| 3 | +## Roll call |
| 4 | + |
| 5 | +(Name / `@GitHubUsername` *[/ Discord, if different]*) |
| 6 | + |
| 7 | +- Petr Viktorin / `@encukou` |
| 8 | +- Ryan / `@ryan-duve` |
| 9 | +- Keith / `@KeithTheEE` |
| 10 | +- Jim DeLaHunt / `@JDLH` / Jim DeLaHunt |
| 11 | +- Jeff |
| 12 | +- Blaise |
| 13 | +- Stan Ulbrych / `@StanFromIreland` |
| 14 | + |
| 15 | + |
| 16 | +## Discussion |
| 17 | + |
| 18 | +- [Jim DeLaHunt] Discord invitation link difficulties. When I |
| 19 | + follow <https://discord.com/invite/vKTkwJKG?event=1347635566518210613>, Discord |
| 20 | + tells me "Invite Invalid", "This invite may be expired, or you might not have |
| 21 | + permission to join". Note also that Google Calendar invite has a different link: |
| 22 | + <https://discord.gg/RxKXyPYV?event=1303462925834522666>. Should it be different? |
| 23 | + And, it causes Discord to give me the same error message. I am a very peripheral |
| 24 | + member of this group, so I am not bothered by not getting access via Discord. |
| 25 | + I can still read the HackMD text. But this Discord behaviour is probably not what is desired. |
| 26 | + - [Petr] Try this link: <https://discord.gg/nECCQWk4up?event=1347635566518210613>. |
| 27 | + - Thank you! That link causes Discord to offer me an invitation, which is great. But then Discord tells me that my browser (current Firefox on macOS) is not supported. Maybe I have to download the Discord app? And the error message says that Firefox is a supported browser. Curious. |
| 28 | + - Weird... I'm on Firefox on Linux & it works for me |
| 29 | + - [Jim] Petr's invitation link worked for me using Safari on macOS. Thank you for your help. |
| 30 | + |
| 31 | +- [Keith] The Translation team has been doing a lot of work. |
| 32 | + |
| 33 | +- [Keith] Wiki work is stalled for the moment, as the team had different, more |
| 34 | + urgent priorities pop up. |
| 35 | + |
| 36 | +- [Keith] Question about how to edit the python.org website; after PyCon focus might move towards that. |
| 37 | + - [Discourse: Process for making changes to the existing python.org website](https://discuss.python.org/t/process-for-making-changes-to-the-existing-python-org-website/89120/7) |
| 38 | + |
| 39 | +- [Blaise] Been holding Sphinx office hours; not many people showed up. |
| 40 | + Some suggestions were to distinguish the audience: |
| 41 | + - have an asynchronous space for newbie questions (e.g. `#sphinx` on [python.org Discourse](https://discuss.python.org/), a Sphinx channel on Python Discord) |
| 42 | + - have a synchronous(ish) space for devs or contributors |
| 43 | + (e.g. the `writeTheDocs` slack folks want to contribute but the [Sphinx contributor guide](https://www.sphinx-doc.org/en/master/internals/contributing.html) |
| 44 | + needs more guidance on how to navigate between `docutils` and `sphinx` . |
| 45 | + There is also a lot of subclassing that makes it hard for a new person to |
| 46 | + know where things are happening. |
| 47 | + - Make it easy for newcomers to lurk and observe activity before joining. |
| 48 | + - [Jim] Add office hours info to the [support page](https://www.sphinx-doc.org/en/master/support.html). |
| 49 | + If I was working on a project and wanted to use Sphinx for docs, and I wanted help, |
| 50 | + I would end up on it. I don't see a mention of office hours on that page. |
| 51 | + |
| 52 | +- [Jeff] Still waiting for guidance on how to take over Indonesian Translation. |
| 53 | +- [Jeff] No update on the [PEP 545 proposals](https://discuss.python.org/t/pep-545-update-pep/83534). |
| 54 | +- [Jeff] Asking for advice about translation management. |
| 55 | + - [Stan] Some useful links if you plan on using transifex: |
| 56 | + - [Python Transifex docs](https://github.com/python-docs-translations/transifex-automations) |
| 57 | + - [Transifex sample workflows (WIP)](https://github.com/python-docs-translations/transifex-automations/pull/130/files) |
0 commit comments