From 21d6fbb923133b496a7d8f414afafdadfa8ee1fb Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Tue, 6 May 2025 21:18:03 +0100 Subject: [PATCH 1/5] Add notes --- docs/monthly-meeting/2024.rst | 18 +++++++++++ docs/monthly-meeting/2025-05.md | 56 +++++++++++++++++++++++++++++++++ docs/monthly-meeting/index.rst | 13 +------- 3 files changed, 75 insertions(+), 12 deletions(-) create mode 100644 docs/monthly-meeting/2024.rst create mode 100644 docs/monthly-meeting/2025-05.md diff --git a/docs/monthly-meeting/2024.rst b/docs/monthly-meeting/2024.rst new file mode 100644 index 0000000..50833a2 --- /dev/null +++ b/docs/monthly-meeting/2024.rst @@ -0,0 +1,18 @@ +Monthly Reports - 2024 +====================== + +.. toctree:: + :maxdepth: 1 + + Jan 2024 <2024-01.md> + Feb 2024 <2024-02.md> + Mar 2024 <2024-03.md> + Apr 2024 <2024-04.md> + May 2024 <2024-05.md> + Jun 2024 <2024-06.md> + Jul 2024 <2024-07.md> + Aug 2024 <2024-08.md> + Sep 2024 <2024-09.md> + Oct 2024 <2024-10.md> + Nov 2024 <2024-11.md> + Dec 2024 <2024-12.md> diff --git a/docs/monthly-meeting/2025-05.md b/docs/monthly-meeting/2025-05.md new file mode 100644 index 0000000..ff5bc60 --- /dev/null +++ b/docs/monthly-meeting/2025-05.md @@ -0,0 +1,56 @@ +# Documentation Community Team Meeting (May 6, 2025) + +## Roll call + +(Name / `@GitHubUsername` *[/ Discord, if different]*) + +- Petr Viktorin / `@encukou` +- Ryan / `@ryan-duve` +- Keith / `@KeithTheEE` +- Jim DeLaHunt / `@JDLH` / Jim DeLaHunt +- Jeff +- Blaise +- Stan Ulbrych / `@StanFromIreland` + + +## Introductions + +> If there are any new people, we should do a round of introductions. + + +## 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. + +- [Name] topic + + +## Discussion + +- [Jim DeLaHunt] Discord invitation link difficulties. +When I (Jim) follow https://discord.com/invite/vKTkwJKG?event=1347635566518210613 , Discord tells me "Invite Invalid", "This invite may be expired, or you might not have permission to join". Note also that Google Calendar invite has a different link, https://discord.gg/RxKXyPYV?event=1303462925834522666 . Should it be different? And, it causes Discord to give me the same error message. +I am a very peripheral member of this group, so I am not bothered by not getting access via Discord. I can still read the HackMD text. But this Discord behaviour is probably not what is desired. + - Try this link: https://discord.gg/nECCQWk4up?event=1347635566518210613 + - 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. + - Weird... I'm on Firefox on Linux & it works for me + - [Jim] The @encukou invitation link worked for me using Safari on macOS. Thank you for your help. + +- [Keith] The Translation team has been doing a lot of work. + +- [Keith] Wiki work is stalled for the moment, as the team had different, more urgent priorities pop up. + +- [Keith] Question about how to edit the python.org website; after PyCon focus might move towards that. + - https://discuss.python.org/t/process-for-making-changes-to-the-existing-python-org-website/89120/7 + +- [Blaise] Been holding Sphinx office hours; not many people showed up. Some suggestions were to distinguish the audience: + - have an asynchronous space for newbie questions (eg. #sphinx on python.org discourse, a sphinx channPython Discord) https://www.sphinx-doc.org/en/master/support.html + - have a synchronous(ish) space for devs or contributors (eg. the `writeTheDocs` slack folks want to contribute but the [sphinx contributor guide](https://www.sphinx-doc.org/en/master/internals/contributing.html) needs more guidance on how to navigate between `docutils` and `sphinx` . There is also a lot of subclassing that makes it hard for a new person to know where things are happening. + - Make it easy for newcomers to lurk and observe activity before joining. + - [Jim] Add office hours info to the (support page)[https://www.sphinx-doc.org/en/master/support.html]. If I was working on a project and wanted to use Sphinx for docs, and I wanted help, I would end up on it. I don't see a mention of office hours on that page. + +- [Jeff] Waiting for guidance on how to take over Indonesian Translation PEP https://discuss.python.org/t/pep-545-update-pep/83534 +- [Jeff] Asking for advice for about translation management: + - Python Transifex docs: https://github.com/python-docs-translations/transifex-automations + - Transifex sample workflows (WIP): https://github.com/python-docs-translations/transifex-automations/pull/130/files diff --git a/docs/monthly-meeting/index.rst b/docs/monthly-meeting/index.rst index 9f077b1..9cbbacc 100644 --- a/docs/monthly-meeting/index.rst +++ b/docs/monthly-meeting/index.rst @@ -16,18 +16,7 @@ Monthly reports in chronological order. 2022 <2022.rst> 2023 <2023.rst> - Jan 2024 <2024-01.md> - Feb 2024 <2024-02.md> - Mar 2024 <2024-03.md> - Apr 2024 <2024-04.md> - May 2024 <2024-05.md> - Jun 2024 <2024-06.md> - Jul 2024 <2024-07.md> - Aug 2024 <2024-08.md> - Sep 2024 <2024-09.md> - Oct 2024 <2024-10.md> - Nov 2024 <2024-11.md> - Dec 2024 <2024-12.md> + 2024 <2024.rst> Jan 2025 <2025-01.md> Feb 2025 <2025-02.md> Mar 2025 <2025-03.md> From bd30d35824d6a5a0da008b0743b0341003e66814 Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Tue, 6 May 2025 21:21:18 +0100 Subject: [PATCH 2/5] Lint --- docs/monthly-meeting/2025-05.md | 2 +- docs/monthly-meeting/index.rst | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/monthly-meeting/2025-05.md b/docs/monthly-meeting/2025-05.md index ff5bc60..319c14b 100644 --- a/docs/monthly-meeting/2025-05.md +++ b/docs/monthly-meeting/2025-05.md @@ -45,7 +45,7 @@ I am a very peripheral member of this group, so I am not bothered by not getting - https://discuss.python.org/t/process-for-making-changes-to-the-existing-python-org-website/89120/7 - [Blaise] Been holding Sphinx office hours; not many people showed up. Some suggestions were to distinguish the audience: - - have an asynchronous space for newbie questions (eg. #sphinx on python.org discourse, a sphinx channPython Discord) https://www.sphinx-doc.org/en/master/support.html + - have an asynchronous space for newbie questions (eg. #sphinx on python.org discourse, a sphinx channPython Discord) https://www.sphinx-doc.org/en/master/support.html - have a synchronous(ish) space for devs or contributors (eg. the `writeTheDocs` slack folks want to contribute but the [sphinx contributor guide](https://www.sphinx-doc.org/en/master/internals/contributing.html) needs more guidance on how to navigate between `docutils` and `sphinx` . There is also a lot of subclassing that makes it hard for a new person to know where things are happening. - Make it easy for newcomers to lurk and observe activity before joining. - [Jim] Add office hours info to the (support page)[https://www.sphinx-doc.org/en/master/support.html]. If I was working on a project and wanted to use Sphinx for docs, and I wanted help, I would end up on it. I don't see a mention of office hours on that page. diff --git a/docs/monthly-meeting/index.rst b/docs/monthly-meeting/index.rst index 9cbbacc..b21fe42 100644 --- a/docs/monthly-meeting/index.rst +++ b/docs/monthly-meeting/index.rst @@ -21,3 +21,4 @@ Monthly reports in chronological order. Feb 2025 <2025-02.md> Mar 2025 <2025-03.md> Apr 2025 <2025-04.md> + May 2025 <2025-05.md> From 81f5310e757e5d954b4d916d64cb37468b624303 Mon Sep 17 00:00:00 2001 From: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> Date: Mon, 12 May 2025 16:10:07 +0100 Subject: [PATCH 3/5] Update docs/monthly-meeting/2025-05.md Co-authored-by: Petr Viktorin --- docs/monthly-meeting/2025-05.md | 14 -------------- 1 file changed, 14 deletions(-) diff --git a/docs/monthly-meeting/2025-05.md b/docs/monthly-meeting/2025-05.md index 319c14b..3ade45f 100644 --- a/docs/monthly-meeting/2025-05.md +++ b/docs/monthly-meeting/2025-05.md @@ -13,20 +13,6 @@ - Stan Ulbrych / `@StanFromIreland` -## Introductions - -> If there are any new people, we should do a round of introductions. - - -## 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. - -- [Name] topic - - ## Discussion - [Jim DeLaHunt] Discord invitation link difficulties. From 0cf0a30210b3068be5e94d181a1b496683acef45 Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Mon, 12 May 2025 16:42:24 +0100 Subject: [PATCH 4/5] Review --- docs/monthly-meeting/2025-05.md | 49 +++++++++++++++++++++------------ 1 file changed, 32 insertions(+), 17 deletions(-) diff --git a/docs/monthly-meeting/2025-05.md b/docs/monthly-meeting/2025-05.md index 3ade45f..08d0e10 100644 --- a/docs/monthly-meeting/2025-05.md +++ b/docs/monthly-meeting/2025-05.md @@ -15,28 +15,43 @@ ## Discussion -- [Jim DeLaHunt] Discord invitation link difficulties. -When I (Jim) follow https://discord.com/invite/vKTkwJKG?event=1347635566518210613 , Discord tells me "Invite Invalid", "This invite may be expired, or you might not have permission to join". Note also that Google Calendar invite has a different link, https://discord.gg/RxKXyPYV?event=1303462925834522666 . Should it be different? And, it causes Discord to give me the same error message. -I am a very peripheral member of this group, so I am not bothered by not getting access via Discord. I can still read the HackMD text. But this Discord behaviour is probably not what is desired. - - Try this link: https://discord.gg/nECCQWk4up?event=1347635566518210613 +- [Jim DeLaHunt] Discord invitation link difficulties. When I + follow , Discord + tells me "Invite Invalid", "This invite may be expired, or you might not have + permission to join". Note also that Google Calendar invite has a different link: + . Should it be different? + And, it causes Discord to give me the same error message. I am a very peripheral + member of this group, so I am not bothered by not getting access via Discord. + I can still read the HackMD text. But this Discord behaviour is probably not what is desired. + - [Petr] Try this link: . - 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. - Weird... I'm on Firefox on Linux & it works for me - - [Jim] The @encukou invitation link worked for me using Safari on macOS. Thank you for your help. + - [Jim] Petr's invitation link worked for me using Safari on macOS. Thank you for your help. - [Keith] The Translation team has been doing a lot of work. -- [Keith] Wiki work is stalled for the moment, as the team had different, more urgent priorities pop up. +- [Keith] Wiki work is stalled for the moment, as the team had different, more + urgent priorities pop up. - [Keith] Question about how to edit the python.org website; after PyCon focus might move towards that. - - https://discuss.python.org/t/process-for-making-changes-to-the-existing-python-org-website/89120/7 - -- [Blaise] Been holding Sphinx office hours; not many people showed up. Some suggestions were to distinguish the audience: - - have an asynchronous space for newbie questions (eg. #sphinx on python.org discourse, a sphinx channPython Discord) https://www.sphinx-doc.org/en/master/support.html - - have a synchronous(ish) space for devs or contributors (eg. the `writeTheDocs` slack folks want to contribute but the [sphinx contributor guide](https://www.sphinx-doc.org/en/master/internals/contributing.html) needs more guidance on how to navigate between `docutils` and `sphinx` . There is also a lot of subclassing that makes it hard for a new person to know where things are happening. + - [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) + +- [Blaise] Been holding Sphinx office hours; not many people showed up. + Some suggestions were to distinguish the audience: + - have an asynchronous space for newbie questions (e.g. `#sphinx` on [python.org Discourse](https://discuss.python.org/), a Sphinx channel on Python Discord) + - have a synchronous(ish) space for devs or contributors + (e.g. the `writeTheDocs` slack folks want to contribute but the [Sphinx contributor guide](https://www.sphinx-doc.org/en/master/internals/contributing.html) + needs more guidance on how to navigate between `docutils` and `sphinx` . + There is also a lot of subclassing that makes it hard for a new person to + know where things are happening. - Make it easy for newcomers to lurk and observe activity before joining. - - [Jim] Add office hours info to the (support page)[https://www.sphinx-doc.org/en/master/support.html]. If I was working on a project and wanted to use Sphinx for docs, and I wanted help, I would end up on it. I don't see a mention of office hours on that page. - -- [Jeff] Waiting for guidance on how to take over Indonesian Translation PEP https://discuss.python.org/t/pep-545-update-pep/83534 -- [Jeff] Asking for advice for about translation management: - - Python Transifex docs: https://github.com/python-docs-translations/transifex-automations - - Transifex sample workflows (WIP): https://github.com/python-docs-translations/transifex-automations/pull/130/files + - [Jim] Add office hours info to the [support page](https://www.sphinx-doc.org/en/master/support.html). + If I was working on a project and wanted to use Sphinx for docs, and I wanted help, + I would end up on it. I don't see a mention of office hours on that page. + +- [Jeff] Still waiting for guidance on how to take over Indonesian Translation. +- [Jeff] No update on the [PEP 545 proposals](https://discuss.python.org/t/pep-545-update-pep/83534). +- [Jeff] Asking for advice about translation management. + - [Stan] Some useful links if you plan on using transifex: + - [Python Transifex docs](https://github.com/python-docs-translations/transifex-automations) + - [Transifex sample workflows (WIP)](https://github.com/python-docs-translations/transifex-automations/pull/130/files) From 0a13367d211da77ca3473d5656a8c256a7d2a45c Mon Sep 17 00:00:00 2001 From: Stan Ulbrych Date: Mon, 12 May 2025 16:44:59 +0100 Subject: [PATCH 5/5] Lint --- docs/monthly-meeting/2025-05.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/monthly-meeting/2025-05.md b/docs/monthly-meeting/2025-05.md index 08d0e10..f039910 100644 --- a/docs/monthly-meeting/2025-05.md +++ b/docs/monthly-meeting/2025-05.md @@ -16,11 +16,11 @@ ## Discussion - [Jim DeLaHunt] Discord invitation link difficulties. When I - follow , Discord + follow , Discord tells me "Invite Invalid", "This invite may be expired, or you might not have permission to join". Note also that Google Calendar invite has a different link: . Should it be different? - And, it causes Discord to give me the same error message. I am a very peripheral + And, it causes Discord to give me the same error message. I am a very peripheral member of this group, so I am not bothered by not getting access via Discord. I can still read the HackMD text. But this Discord behaviour is probably not what is desired. - [Petr] Try this link: .