Skip to content

Commit cd1493e

Browse files
authored
Add notes from the 2023-02 meeting (#73)
1 parent 536d641 commit cd1493e

File tree

2 files changed

+126
-0
lines changed

2 files changed

+126
-0
lines changed

docs/monthly-meeting/2023-02.md

Lines changed: 125 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,125 @@
1+
# Documentation Community Team Meeting (February 2023)
2+
3+
- **Date:** 2023-02-06
4+
- **Time:** [20:00 UTC](https://arewemeetingyet.com/UTC/2023-01-09/20:00/Docs%20Meeting)
5+
- **This HackMD:** https://hackmd.io/@encukou/pydocswg1
6+
- [**Discourse thread**](https://discuss.python.org/t/documentation-community-meeting-february-6-2023/23320) (for February)
7+
- [**January meeting's report**](https://docs-community.readthedocs.io/en/latest/monthly-meeting/2023-01.html)
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+
## Roll call
17+
18+
- Mariatta `@mariatta`
19+
- Petr `@encukou`
20+
- Erlend `@erlend-aasland`
21+
- Hugo `@hugovk`
22+
- Ezio `@ezio-melotti`
23+
- CAM `@cam-gerlach`
24+
- Jim DeLaHunt `@JDLH`
25+
26+
27+
## Reports and celebrations
28+
29+
> 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.
30+
>
31+
32+
> 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.
33+
34+
* devguide: Release cycle chart generated directly as SVG [python/devguide#1034](https://github.com/python/devguide/pull/1034)
35+
36+
* PEP Pull Request templates are live. The feature needs some more polish from GitHub's side to be fully useful
37+
38+
* CAM's script for keeping What's New versions in sync is almost ready!
39+
40+
* PEPs infra: relative links to ease development [#2972](https://github.com/python/peps/pull/2972), remove feedgen/lxml dependency to test Python 3.12-dev [#2973], use dark grey instead of dark green for dark theme background [#2977], use consistent 'make html' and 'make dirhtml' [#2968] and 'make htmlview'
41+
42+
* Pradyun has a PR, [python/peps#2992](https://github.com/python/peps/pull/2992) on review to make the banners sticky; should be almost ready to go pending a few minor tweaks to browser-specific issues
43+
44+
* PEPs topic PRs: PEP 1 and 12: Document Topic header [#2995], Add a governance topic [#2993], PEP 404: Add Python 2.8 to Release PEPs topic [#2986]
45+
46+
[#2972]: https://github.com/python/peps/pull/2972
47+
[#2973]: https://github.com/python/peps/pull/2973
48+
[#2977]: https://github.com/python/peps/pull/2977
49+
[#2968]: https://github.com/python/peps/pull/2968
50+
[#2995]: https://github.com/python/peps/pull/2995
51+
[#2993]: https://github.com/python/peps/pull/2993
52+
[#2986]: https://github.com/python/peps/pull/2986
53+
54+
55+
56+
57+
## Discussion
58+
59+
### 'Internal' items
60+
61+
*For and about the Community or Working Group*
62+
63+
- Trouble installing Python: https://mail.python.org/archives/list/[email protected]/thread/I7JDNUYWIZ3QVY33IDYWFKDTZMIPIVNS/
64+
- https://docs.python.org/3/using/mac.html#running-scripts-with-a-gui
65+
66+
- Overhaul Building the Documentation section for clarity
67+
- https://github.com/python/devguide/pull/1038
68+
69+
- [python/devguide#1020](https://github.com/python/devguide/issues/1020): Function signatures in docs (positional-only markers, defaults, `[]` syntax)
70+
- How discoverable is the `[]` syntax to today's devs?
71+
72+
- The docs mailing list ([email protected])
73+
- This is linked from docs.python.org from "report a bug" section https://docs.python.org/3/bugs.html#documentation-bugs
74+
- [python/devguide#1025](https://github.com/python/devguide/pull/1025)
75+
- **Mariatta** file an issue or PR for Python docs
76+
- [Issue](https://github.com/python/cpython/issues/101616), [PR](https://github.com/python/cpython/pull/101617)
77+
78+
* Release cycle chart in the Devguide
79+
* [python/devguide#1034](https://github.com/python/devguide/pull/1034) merged!
80+
* Possible next steps:
81+
* Use inline CSS
82+
* Put in individual release dates
83+
84+
* draft: Previews in pull requests #105 - need to set up RTD
85+
https://github.com/python/python-docs-theme/pull/105
86+
* **Mariatta** to set up an organization account on Read the Docs
87+
88+
89+
### Python Project Documentation
90+
91+
*Relating to `docs.python.org`, `peps.python.org`, `devguide.python.org`, etc.*
92+
93+
* https://packaging.python.org/en/latest/glossary/
94+
* @CAM-Gerlach to improve the glossary. It can then be linked or copied to CPython docs.
95+
* improved glossary is part of PEP 639
96+
97+
### Improve SEO for CPython docs
98+
99+
* (Hugo) OpenGraph metadata PRs:
100+
101+
* About the extension creating social media cards, asked Ee and Julien about deploying all the images in https://github.com/python/docsbuild-scripts/issues/147
102+
* Hugo: I suggest we disable the images when available, then enable after testing the points raised in the issue (only enable for web docs, check translations, don't include in archives)
103+
104+
### PEPs styling
105+
106+
* (Hugo) I find the Google font, small size and tight spacing hard to read. The Google font loading causes a big initial layout shift. Trying it out with default fonts and spacing feels more readable, faster loads.
107+
* https://hugovk-peps.readthedocs.io/en/sfs/pep-0703/
108+
* https://peps.python.org/pep-0703/
109+
* Originally discussed https://discuss.python.org/t/styling-of-peps/13270/34
110+
111+
* CPython docs styling is waiting for Lutra docs
112+
113+
### PEP Workflow
114+
115+
* [PEP 1 rewrite?](https://discuss.python.org/t/21068/26)
116+
* Final PEPs and the canonical docs banner link: in PR [python/peps#2992](https://github.com/python/peps/pull/2992)
117+
* Status for PEP 659 and other obsolete PEPs?
118+
119+
120+
## Next meeting
121+
122+
The docs team generally meets on the first Monday of every month.
123+
124+
We have a recurring Google Calendar event for the meeting.
125+
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
@@ -23,3 +23,4 @@ Monthly reports in reverse chronological order.
2323
Nov 2022 <2022-11.md>
2424
Dec 2022 <2022-12.md>
2525
Jan 2023 <2023-01.md>
26+
Feb 2023 <2023-02.md>

0 commit comments

Comments
 (0)