Skip to content

Commit 3afb6dc

Browse files
authored
Merge pull request #92 from egeakman/november
2 parents ce0afea + 5847738 commit 3afb6dc

File tree

2 files changed

+78
-0
lines changed

2 files changed

+78
-0
lines changed

docs/monthly-meeting/2023-11.md

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
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)
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+
56+
- CLI enhancements and features
57+
- If you have some spare time and nothing else to do, feel free to contribute!
58+
59+
- [Adam/Ege/Hugo] Frequency of docs.python.org builds
60+
- We used to build all translations & versions
61+
- Now we only build those that have changed, which reduces the build time.
62+
- There is still room for improvement: [python/docsbuild-scripts#171 (comment)](https://github.com/python/docsbuild-scripts/pull/171#issuecomment-1767764506)
63+
64+
- [Ege/Hugo/CAM] Analytics (Plausible) - CAM sent an e-mail (around late October), no reply yet
65+
66+
- [Usman] As a beginner, what's a good starting point?
67+
- There are some "easy" issues, although they can occasionally not be actually-easy.
68+
- Interested in documentation, look at diataxis and make changes?
69+
- Diataxis is kind of abstract for newcomers.
70+
71+
72+
## Next meeting
73+
74+
The docs team generally meets on the first Tuesday of every month around 20:00-ish UTC.
75+
76+
We have a recurring Google Calendar event for the meeting.
77+
Let Mariatta know your email address and she can invite you.

docs/monthly-meeting/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,3 +32,4 @@ Monthly reports in reverse chronological order.
3232
Aug 2023 <2023-08.md>
3333
Sep 2023 <2023-09.md>
3434
Oct 2023 <2023-10.md>
35+
Nov 2023 <2023-11.md>

0 commit comments

Comments
 (0)