python · willingc · Apr 2, 2025 · Mar 6, 2025 · Mar 6, 2025 · Mar 6, 2025
diff --git a/docs/community/community-guide.md b/docs/community/community-guide.md
@@ -11,9 +11,9 @@ a quick list to get you started.
 
 - [devguide](https://devguide.python.org)
 - [docs](https://docs.python.org)
-- python_docs_theme
+- [Python Docs Sphinx Theme](https://github.com/python/python-docs-theme)
 - [discourse category](https://discuss.python.org/c/documentation/26)
-- Discord server
+- [Discord server](https://discord.gg/sMWqvzXvd)
 
 ### General information about communication channels
 

diff --git a/docs/community/index.rst b/docs/community/index.rst
@@ -17,4 +17,5 @@ The Documentation Community Team has a Code of Conduct
 
     contributing
     community-guide
+    monthly-meeting
     skills
diff --git a/docs/community/monthly-meeting.rst b/docs/community/monthly-meeting.rst
@@ -0,0 +1,20 @@
+.. _monthly-meeting:
+
+Documentation Community Monthly Meetings
+========================================
+
+Monthly meetings are held on the first Tuesday of the month generally around 19:00
+or 20:00 UTC on the `Discord server <https://discord.gg/sMWqvzXvde>`_ and last one hour.
+Check the agenda or Discourse announcement to verify the start time.
+
+The agenda and later the meeting minutes are written in the `HackMD <https://hackmd.io/@encukou/pydocswg1>`_.
+To edit notes, click the “pencil” or “split view” button on the `HackMD Document <https://hackmd.io/@encukou/pydocswg1>`_.
+You will need to log in with, for example, a GitHub account.
+
+To receive notifications about upcoming meetings you can click the "Interested"
+button in the `Discord server <https://discord.gg/sMWqvzXvde>`_ events page. To
+receive email notifications contact Mariatta in the Discord server.
+
+By participating in meetings, you are agreeing to abide by and uphold the
+`PSF Code of Conduct <https://policies.python.org/python.org/code-of-conduct/>`_.
+Please take a second to read through it!
diff --git a/docs/monthly-meeting/2022-02.md b/docs/monthly-meeting/2022-02.md
@@ -1,13 +1,5 @@
-# Docs WG Agenda/Minutes -- February 2022
+# Documentation Community's Team Meeting (February 7, 2022)
 
-- **Date:** 2022-01-07
-- **Time:** [22:00 UTC](https://arewemeetingyet.com/UTC/2022-02-07/22:00/Docs%20WG)
-- **This HackMD:** [https://hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)
-- **GitHub issue:** Agenda Planning Issue
-- **Calendar for future meetings:** XXX
-
-By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/).
-Please take a second to read through it!
 
 ## Quick updates - Introductions
 
@@ -68,7 +60,7 @@ A "guidance document is at the end of the document"
 
 [Julien] Maybe we need guidelines, maybe not. We can definitely review PRs.
 
-[Petr] We don't need to write the rules before hand, to block our work. We can start by just reviewing stuff.
+[Petr] We don't need to write the rules beforehand, to block our work. We can start by just reviewing stuff.
 
 [Carol] I think that's a good way to start. Because this is both core devs& non-core devs, if there's an issue it should come back to this agenda, instead of a mailing list.
 
@@ -188,7 +180,7 @@ From the issue tracker:
   - Suggestions and ideas from Typing Summit [python/docs-community#8](https://github.com/python/docs-community/issues/8)
   - French translation sprint [python/docs-community#9](https://github.com/python/docs-community/issues/9)
   - Use Sphinx for pep builds and better rendering [python/docs-community#10](https://github.com/python/docs-community/issues/10)
-    > This seems to be progressing well mostly thanks to Adam's work; we just need to do some tweaks to the styling and appearance; main blocker is just PEP 676's approval and then getting the infra moved over to whatever we decide on (RTD, GHP, Netlify, etc). A huge improvement and going to unlock a lot of possibilities going forward while being far more maintainable than the hacked-together legacy csystem. I'm a little unsure if this is directly within scope here, though. [CAM-Gerlach]
+    > This seems to be progressing well mostly thanks to Adam's work; we just need to do some tweaks to the styling and appearance; main blocker is just PEP 676's approval and then getting the infra moved over to whatever we decide on (RTD, GHP, Netlify, etc.). A huge improvement and going to unlock a lot of possibilities going forward while being far more maintainable than the hacked-together legacy csystem. I'm a little unsure if this is directly within scope here, though. [CAM-Gerlach]
     - Is it in scope? :)
   - Having a "fast path" for documentation contributions [python/docs-community#13](https://github.com/python/docs-community/issues/13)
   - Move language selection to a dedicated page? [python/docs-community#14](https://github.com/python/docs-community/issues/14)

diff --git a/docs/monthly-meeting/2022-03.md b/docs/monthly-meeting/2022-03.md
@@ -1,18 +1,10 @@
-# Documentation Community's Team Meeting (March 2022)
-
-- **Date:** 2022-03-07
-- **Time:** [22:00 UTC](https://arewemeetingyet.com/UTC/2022-02-07/22:00/Docs%20WG)
-- **This HackMD:** [https://hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)
-- **GitHub issue:** Agenda Planning Issue
-- **Calendar for future meetings:** XXX
-
-By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/).
-Please take a second to read through it!
+# Documentation Community's Team Meeting (March 7, 2022)
 
 
 ## Roll call
 
-- name / affiliation / `@github-username`
+(Name / affiliation / `@GitHubUsername`)
+
 - Petr / RedHat, SC / `@encukou`
 - Mariatta / Core Dev / `@mariatta`
 - Pradyun / ??? / `@pradyunsg`

diff --git a/docs/monthly-meeting/2022-04.md b/docs/monthly-meeting/2022-04.md
@@ -1,18 +1,10 @@
-# Documentation Community's Team Meeting (April 2022)
-
-- **Date:** 2022-04-04
-- **Time:** [21:00 UTC](https://arewemeetingyet.com/UTC/2022-04-04/21:00/Docs%20Meeting)
-- **This HackMD:** [https://hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)
-- **GitHub issue:** Agenda Planning Issue
-- **Calendar for future meetings:** (send your e-mail to Mariatta for a calendar invitation)
-
-By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/).
-Please take a second to read through it!
+# Documentation Community's Team Meeting (April 4, 2022)
 
 
 ## Roll call
 
-- name / `@github-username`
+(Name / `@GitHubUsername`)
+
 - Petr / `@encukou`
 - Mariatta / `@mariatta`
 - Ned / `@nedbat`

diff --git a/docs/monthly-meeting/2022-05.md b/docs/monthly-meeting/2022-05.md
@@ -1,17 +1,10 @@
-# Documentation Community Team Meeting (May 2022)
+# Documentation Community Team Meeting (May 2, 2022)
 
-- **Date:** 2022-05-02
-- **Time:** [21:00 UTC](https://arewemeetingyet.com/UTC/2022-04-04/21:00/Docs%20Meeting) (!! one hour earlier due to daylight savings, speak up if this is a problem !!)
-- **This HackMD:** [https://hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)
-- **GitHub issue:** Agenda Planning Issue
-- **Calendar for future meetings:** (send your e-mail to Mariatta for a calendar invitation)
-
-By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/).
-Please take a second to read through it!
 
 ## Roll call
 
-- name / `@github-username`
+(Name / `@GitHubUsername`)
+
 - Mariatta / `@mariatta`
 - Carol / `@willingc`
 - Adam T / `@AA-Turner`

diff --git a/docs/monthly-meeting/2022-06.md b/docs/monthly-meeting/2022-06.md
@@ -1,18 +1,10 @@
-# Documentation Community Team Meeting (June 2022)
+# Documentation Community Team Meeting (June 6, 2022)
 
-- **Date:** 2022-06-06
-- **Time:** [21:00 UTC](https://arewemeetingyet.com/UTC/2022-06-06/21:00/Docs%20Meeting)
-- **This HackMD:** [https://hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)
-- **GitHub issue:** Agenda Planning Issue
-- **Calendar for future meetings:** (send your e-mail to Mariatta for a calendar invitation)
-- **How to participate:** Use the "General Voice" channel (it does video); hover over "General Voice" in the side bar and click in the "speech balloon" to bring up the side chat
-
-By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/).
-Please take a second to read through it!
 
 ## Roll call
 
-- name / `@github-username`
+(Name / `@GitHubUsername`)
+
 - Adam Turner / `@AA-Turner`
 - Guido van Rossum / `@gvanrossum`
 - Petr Viktorin / `@encukou`

diff --git a/docs/monthly-meeting/2022-07.md b/docs/monthly-meeting/2022-07.md
@@ -1,21 +1,10 @@
-# Documentation Community Team Meeting (July 2022)
+# Documentation Community Team Meeting (July 11, 2022)
 
-- **Date:** 2022-07-11
-- **Time:** [21:00 UTC]<!--(https://arewemeetingyet.com/UTC/2022-07-11/21:00/Docs%20Meeting)-->
-- **This HackMD:** [https://hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)
-- **Discourse thread:** [discuss.python.org/t/16317](https://discuss.python.org/t/16317)
-- **Calendar for future meetings:** (send your e-mail to Mariatta for a calendar invitation)
-- **How to participate:**
-  - Join the Python Docs discord: [discord.gg/sMWqvzXvde](https://discord.gg/sMWqvzXvde)
-  - Use the "General Voice" channel (it does video)
-  - To bring up the side chat: click in the "speech balloon" in General Voice (on Web/desktop, hover over "General Voice" in the side bar to see it)
-
-By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/).
-Please take a second to read through it!
 
 ## Roll call
 
-- name / `@github-username`
+(Name / `@GitHubUsername`)
+
 - Adam Turner / `@AA-Turner`
 - Petr Viktorin / `@encukou`
 - C.A.M. Gerlach / `@CAM-Gerlach`

diff --git a/docs/monthly-meeting/2022-08.md b/docs/monthly-meeting/2022-08.md
@@ -1,18 +1,10 @@
-# Documentation Community Team Meeting (August 2022)
+# Documentation Community Team Meeting (August 1, 2022)
 
-- **Date:** 2022-08-01
-- **Time:** [21:00 UTC]<!--(https://arewemeetingyet.com/UTC/2022-08-01/21:00/Docs%20Meeting)-->
-- **This HackMD:** [https://hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)
-- **Discourse thread:** [discuss.python.org/t/documentation-community-meeting-august-1/17847](https://discuss.python.org/t/documentation-community-meeting-august-1/17847)
-- **Calendar for future meetings:** (send your e-mail to Mariatta for a calendar invitation)
-- **How to participate:**
-  -  Go to [Google Meet](https://meet.google.com/dii-qrzf-wkw) and ask to be let in.
-
-By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/).
-Please take a second to read through it!
 
 ## Roll call
 
+(Name / `@GitHubUsername`)
+
 - Mariatta / `@Mariatta`
 - Petr Viktorin / `@encukou`
 - Hugo van Kemenade / `@hugovk`

diff --git a/docs/monthly-meeting/2022-09.md b/docs/monthly-meeting/2022-09.md
@@ -1,20 +1,10 @@
-# Documentation Community Team Meeting (September 2022)
-
-- **Date:** 2022-09-12
-- **Time:** [21:00 UTC](https://arewemeetingyet.com/UTC/2022-09-12/21:00/Docs%20Meeting)
-- **This HackMD:** [https://hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)
-- **Discourse thread:** [discuss.python.org/t/18590](https://discuss.python.org/t/18590)
-- **Calendar for future meetings:** (send your e-mail to Mariatta for a calendar invitation)
-- **How to participate:**
-  -  Go to [Google Meet](https://meet.google.com/dii-qrzf-wkw) and ask to be let in.
-  -  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).
-
-By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/).
-Please take a second to read through it!
+# Documentation Community Team Meeting (September 12, 2022)
 
 
 ## Roll call
 
+(Name / `@GitHubUsername`)
+
 - Petr Viktorin / `@encukou`
 - Ezio Melotti / `@ezio-melotti`
 - Mariatta / `@mariatta`

diff --git a/docs/monthly-meeting/2022-10.md b/docs/monthly-meeting/2022-10.md
@@ -1,26 +1,16 @@
-# Documentation Community Team Meeting (October 2022)
+# Documentation Community Team Meeting (October 3, 2022)
 
-- **Date:** 2022-10-03
-- **Time:** [19:30 UTC](https://arewemeetingyet.com/UTC/2022-10-03/19:30/Docs%20Meeting)
-- **This HackMD:** [https://hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)
-- [**Discourse thread**](https://discuss.python.org/t/19070) for October
-- **Calendar for future meetings:** (send your e-mail to Mariatta for a calendar invitation)
-- **How to participate:**
-  -  Go to [Google Meet](https://meet.google.com/dii-qrzf-wkw) and ask to be let in.
-  -  To edit notes, click the “pencil” or “split view” button on the [hackMD document]
-  -  ([hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)). You need to log in (e.g. with a GitHub account).
-
-By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/).
-Please take a second to read through it!
 
 ## Roll call
 
+(Name / `@GitHubUsername`)
+
 - Petr Viktorin / `@encukou`
 - Adam T / `@AA-Turner`
 - Ezio Melotti / `@ezio-melotti`
 - Hugo van Kemenade / `@hugovk`
-- Mariatta / `mariatta`
-- Joannah / `nanjekyejoannah`
+- Mariatta / `@mariatta`
+- Joannah / `@nanjekyejoannah`
 - Alex Waygood / `@AlexWaygood`
 - CAM Gerlach / `@CAM-Gerlach`
 - Pradyun / `@pradyunsg`

diff --git a/docs/monthly-meeting/2022-11.md b/docs/monthly-meeting/2022-11.md
@@ -1,23 +1,12 @@
-# Documentation Community Team Meeting (November 2022)
+# Documentation Community Team Meeting (November 7, 2022)
 
-- **Date:** 2022-11-07
-- **Time:** [19:30 UTC](https://arewemeetingyet.com/UTC/2022-11-07/19:30/Docs%20Meeting)
-- **This HackMD:** [https://hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)
-- [**Discourse thread**](https://discuss.python.org/t/20057) (for November)
-- **Calendar event:** (send your e-mail to Mariatta for an invitation)
-- **How to participate:**
-  -  Go to [Google Meet](https://meet.google.com/dii-qrzf-wkw) and ask to be let in.
-  -  To edit notes, click the “pencil” or “split view” button on the [hackMD document]  ([hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)). You need to log in (e.g. with a GitHub account).
-
-By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/).
-Please take a second to read through it!
 
 ## Roll call
 
 - Mariatta / `@mariatta`
-- Jim DeLaHunt / @JDLH
+- Jim DeLaHunt / `@JDLH`
 - Ezio Melotti / `@ezio-melotti`
-- Erlend Aasland / @erlend-aasland
+- Erlend Aasland / `@erlend-aasland`
 - Hugo van Kemenade / `@hugovk`
 - Ned Batchelder / `@nedbat`
 - C.A.M. Gerlach / `@CAM-Gerlach`

diff --git a/docs/monthly-meeting/2022-12.md b/docs/monthly-meeting/2022-12.md
@@ -1,19 +1,10 @@
-# Documentation Community Team Meeting (December 2022)
+# Documentation Community Team Meeting (December 5, 2022)
 
-- **Date:** 2022-12-05
-- **Time:** [20:00 UTC](https://arewemeetingyet.com/UTC/2022-12-05/20:00/Docs%20Meeting)
-- **This HackMD:** [https://hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)
-- [**Discourse thread**](https://discuss.python.org/t/21578)
-- **Calendar event:** (send your e-mail to Mariatta for an invitation)
-- **How to participate:**
-  -  Go to [Google Meet](https://meet.google.com/dii-qrzf-wkw) and ask to be let in.
-  -  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).
-
-By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/).
-Please take a second to read through it!
 
 ## Roll call
 
+(Name / `@GitHubUsername`)
+
 - Mariatta / `@mariatta`
 - Petr / `@encukou`
 - Ezio / `@ezio-melotti`

diff --git a/docs/monthly-meeting/2023-01.md b/docs/monthly-meeting/2023-01.md
@@ -1,25 +1,15 @@
-# Documentation Community Team Meeting (January 2023)
-
-- **Date:** 2023-01-09
-- **Time:** [20:00 UTC](https://arewemeetingyet.com/UTC/2023-01-09/20:00/Docs%20Meeting)
-- **This HackMD:** [https://hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)
-- [**Discourse thread**](https://discuss.python.org/t/documentation-community-meeting-january-9/22039) (for January)
-- **Calendar event:** (send your e-mail to Mariatta for an invitation)
-- **How to participate:**
-  -  Go to [Google Meet](https://meet.google.com/dii-qrzf-wkw) and ask to be let in.
-  -  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).
-
-By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/).
-Please take a second to read through it!
+# Documentation Community Team Meeting (January 9, 2023)
 
 
 ## Roll call
 
-- Petr Viktorin, `@encukou`
-- Jim DeLaHunt, `@JDLH` (a conflict in real life took him away for 20 minutes)
-- Mariatta `@mariatta`
-- Hugo van Kemenade `@hugovk`
-- C.A.M. Gerlach `@CAM-Gerlach`
+(Name / `@GitHubUsername`)
+
+- Petr Viktorin / `@encukou`
+- Jim DeLaHunt / `@JDLH` (a conflict in real life took him away for 20 minutes)
+- Mariatta / `@mariatta`
+- Hugo van Kemenade / `@hugovk`
+- C.A.M. Gerlach / `@CAM-Gerlach`
 
 
 ## Quick updates - Introductions

diff --git a/docs/monthly-meeting/2023-02.md b/docs/monthly-meeting/2023-02.md
@@ -1,27 +1,17 @@
-# Documentation Community Team Meeting (February 2023)
+# Documentation Community Team Meeting (February 6, 2023)
 
-- **Date:** 2023-02-06
-- **Time:** [20:00 UTC](https://arewemeetingyet.com/UTC/2023-01-09/20:00/Docs%20Meeting)
-- **This HackMD:** [https://hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1)
-- [**Discourse thread**](https://discuss.python.org/t/documentation-community-meeting-february-6-2023/23320) (for February)
-- [**January meeting's report**](https://docs-community.readthedocs.io/en/latest/monthly-meeting/2023-01.html)
-- **Calendar event:** (send your e-mail to Mariatta for an invitation)
-- **How to participate:**
-  -  Go to [Google Meet](https://meet.google.com/dii-qrzf-wkw) and ask to be let in.
-  -  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).
-
-By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/).
-Please take a second to read through it!
 
 ## Roll call
 
-- Mariatta `@mariatta`
-- Petr `@encukou`
-- Erlend `@erlend-aasland`
-- Hugo `@hugovk`
-- Ezio `@ezio-melotti`
-- CAM `@cam-gerlach`
-- Jim DeLaHunt `@JDLH`
+(Name / `@GitHubUsername`)
+
+- Mariatta / `@mariatta`
+- Petr / `@encukou`
+- Erlend / `@erlend-aasland`
+- Hugo / `@hugovk`
+- Ezio / `@ezio-melotti`
+- CAM / `@cam-gerlach`
+- Jim DeLaHunt / `@JDLH`
 
 
 ## Reports and celebrations