Skip to content

Commit f2668c9

Browse files
Add meeting notes from October (#89)
* Add meeting notes from October * Apply suggestions from code review Co-authored-by: Ezio Melotti <[email protected]>
1 parent 73f6bb6 commit f2668c9

File tree

2 files changed

+79
-0
lines changed

2 files changed

+79
-0
lines changed

docs/monthly-meeting/2023-10.md

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
# Documentation Community Team Meeting (October 2023)
2+
3+
- **Date:** 2023-10-03
4+
- **Time:** [19:00 UTC](https://arewemeetingyet.com/UTC/2023-10-03/19:00/Docs%20Meeting)
5+
- **This HackMD:** https://hackmd.io/@encukou/pydocswg1
6+
- [**Discourse thread**](https://discuss.python.org/t/34318) (for October)
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+
- Hugo van Kemenade / `@hugovk`
21+
- Petr Viktorin / `@encukou`
22+
- Ned Batchelder / `@nedbat`
23+
- Daniele Procida / `@evildmp`
24+
- Mariatta / `@mariatta`
25+
- Marcus Sherman / `@betteridiot`
26+
- Adam T / `@AA-Turner`
27+
- Ryan Duve / `@ryan-duve`
28+
- CAM Gerlach / `@CAM-Gerlach`
29+
- Ege Akman / `@egeakman`
30+
- Carol Willing / `@willingc` / `carolwilling`
31+
32+
33+
## Reports and celebrations
34+
35+
- Python 3.12.0 has been released:
36+
- [Python 3.12.0 (final) is here](https://discuss.python.org/t/35186)
37+
- [Python Release Python 3.12.0 | Python.org](https://www.python.org/downloads/release/python-3120/)
38+
- [What’s New In Python 3.12 — Python 3.12.0 documentation](https://docs.python.org/3.12/whatsnew/3.12.html)
39+
- [Hugo] python-docs-theme:
40+
- [python-docs-theme 2023.8 has been released](https://pypi.org/project/python-docs-theme/2023.8/)
41+
- Releasing via Trusted Publishers has been set up on PyPI: [python/python-docs-theme#148](https://github.com/python/python-docs-theme/pull/148)
42+
- [Adam] [Editorial work on *What's New in Python 3.12*](https://docs.python.org/3.12/whatsnew/3.12.html)
43+
- [Adam] Work on improving [Sphinx's documentation](https://www.sphinx-doc.org/en/master):
44+
- [New pages for the first-party Domains](https://www.sphinx-doc.org/en/master/usage/domains/)
45+
- [Improved documentation for *make-mode*](https://www.sphinx-doc.org/en/master/man/sphinx-build.html#options)
46+
- [A quick reference for the most common builders](https://www.sphinx-doc.org/en/master/usage/builders/index.html)
47+
- [Adam] [Almost every reference to Distutils has been removed or replaced in Python 3.12's documentation](https://github.com/python/cpython/issues/92584). Though [some](https://docs.python.org/dev/search.html?q=distutils) remain!
48+
- [Mariatta] [PEP Talk video](https://www.youtube.com/watch?v=7OHGugQkYzA) at North Bay Python + this Saturday at [PyGotham](https://2023.pygotham.tv/)
49+
- [CAM] [Free Google online technical/docs writing workshops](https://developers.google.com/tech-writing/announcements), first one tomorrow at 16:30 UTC; thanks Hugo for sharing it! Offline bit short but useful, and online sounds very hands on and interactive learning, which should be fun. CAM will be there and hopes you will too.
50+
- [Petr] Thanks Hugo for the announcement, Ege for the PR and Adam for cleaning the HackMD pad!
51+
52+
53+
## Discussion
54+
55+
- [Adam] Frequency of rebuilds of [`docs.python.org/3/`](https://docs.python.org/3/): [python/docsbuild-scripts#163](https://github.com/python/docsbuild-scripts/issues/163)
56+
- Is it OK for the PDFs to lag behind the HTML pages?
57+
- We could build English HTML every 4-6 hours but translations & PDFs only daily.
58+
- We don't know how long the build takes.
59+
- Could we move to Read the Docs?
60+
- Perhaps redirect 404s for archives that aren't build yet to earlier versions: could `https://docs.python.org/3.11/archives/python-3.11.999-docs-pdf-letter.zip` serve HTML that explains things and links to `https://docs.python.org/3.11/archives/` ?
61+
- Action: Adam to write up something & ask Julien.
62+
- [Hugo] Adopting opengraph preview images for d.p.o: [python/docsbuild-scripts#147](https://github.com/python/docsbuild-scripts/issues/147)
63+
- [Adam] Shutting down [`[email protected]`](https://mail.python.org/archives/list/[email protected]/latest)
64+
- Action: Petr to think about / redirect posts to GH Issues.
65+
- [Mariatta/Joanna/Ned] [PEP for Python Editorial Board](https://docs.google.com/document/d/1IDaf87xtuKQ9txA6XUS-kQbgmLseUrOD1EBwl5PheSw/edit?usp=sharing)
66+
- [Ege] What is the status of "[analysing docs.python.org using Google Search Console](https://github.com/python/docs-community/issues/64)"?
67+
- Would have been nice to have, but doesn't look feasible for now. Hopefully, it will be discussed along with *Plausible hosting*.
68+
- We can look into alternatives, such as [Google LightHouse](https://developer.chrome.com/docs/lighthouse/overview/).
69+
- [Ege/Hugo/Maciej/CAM] Plausible & Weblate hosting updates (response from the PSF?)
70+
- [CAM] Emailed Deb a couple weeks ago with the summary of our consensus on the last meeting, but still waiting (again :( ) on a reply.
71+
72+
73+
## Next meeting
74+
75+
The docs team generally meets on the first Tuesday of every month around 19:00-ish UTC.
76+
77+
We have a recurring Google Calendar event for the meeting.
78+
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
@@ -31,3 +31,4 @@ Monthly reports in reverse chronological order.
3131
Jul 2023 <2023-07.md>
3232
Aug 2023 <2023-08.md>
3333
Sep 2023 <2023-09.md>
34+
Oct 2023 <2023-10.md>

0 commit comments

Comments
 (0)