-
-
Notifications
You must be signed in to change notification settings - Fork 25
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
- Loading branch information
1 parent
3d51545
commit cc80dd2
Showing
2 changed files
with
85 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,84 @@ | ||
# Documentation Community Team Meeting (May 2024) | ||
|
||
- **Date:** 2024-05-07 | ||
- **Time:** [19:00 UTC](https://arewemeetingyet.com/UTC/2024-05-07/19:00/Docs%20Meeting) | ||
- **This HackMD:** https://hackmd.io/@encukou/pydocswg1 | ||
- [**Discourse thread**](https://discuss.python.org/t/documentation-community-meeting-tuesday-7th-may-2024/52404) (for May) | ||
- [**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)) | ||
- **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` *[/ Discord, if different]*) | ||
|
||
- Ned Batchelder / `@nedbat` | ||
- Petr Viktorin / `@encukou` | ||
- Ryan Duve / `@ryan-duve` | ||
- Eric | ||
- Hugo van Kemenade / `@hugovk` | ||
- CAM / `@CAM-Gerlach` | ||
- Erlend Aasland / `@erlend-aasland` | ||
|
||
|
||
## 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. | ||
- Python 3.13 beta happening. | ||
- Announced in [discuss.python.org](https://discuss.python.org/t/python-3-13-0-beta-1-is-near/52794) | ||
- [Calendar ical .ics](https://github.com/fedora-python/python-release-schedule-ical) | ||
|
||
- Ryan is teaching Python to 5th-graders 🎉 | ||
|
||
## Discussion | ||
|
||
- [Petr] Found some older PRs that didn't get to Beta | ||
- Intersphinx in CPython docs -- [python/cpython#117540](https://github.com/python/cpython/pull/117540) | ||
- Redistributors build docs while offline. This change shouldn't be merged during beta. On May 8th main will be 3.14 alpha, it could be merged then. | ||
- Would also be good to map urls to local file paths for offline use. Open edX might have something like this to keep tests from breaking as different docs update at different rates. | ||
- Module page titles starting with a link to themselves -- [python/cpython#117099](https://github.com/python/cpython/pull/117099) | ||
- Didn't want to ping 29 code owners. | ||
- But they get pings a lot anyway. | ||
- A custom Sphinx plugin could prevent links in all section headers instead. | ||
- The plugin could also take care of links in sections/paragraphs to the sections/paragraphs. | ||
- This leads to the question of whether a human or an algorithm should make this decision. | ||
- Practically: merging this would be a good thing | ||
- Can we have a linter for links in section heads? | ||
- We could add a rule to [Sphinx Lint](https://pypi.org/project/sphinx-lint/). | ||
- Merge versionchanged directives for the same version -- [python/cpython#116456](https://github.com/python/cpython/pull/116456) | ||
- We agree unanimously that the status quo is better; we'll close the PR. | ||
- Serhyi's other contributions on the issue are great, though! | ||
|
||
|
||
- [Hugo] RTD migration work continuing: [python/docs-community#5](https://github.com/python/docs-community/issues/5), have a WIP version and language selector at [https://cpython-previews.readthedocs.io/en/main/](https://cpython-previews.readthedocs.io/en/main/) | ||
- Manuel has done a lot of work on this (and Hugo has reviewed it) | ||
- The goal is to rebuild after every merge. Or a bit less, but more than the current daily builds | ||
- The plan is to move HTML first, but then look at other formats too. | ||
|
||
- [Petr] [`.. versionchanged:: next`](https://discuss.python.org/t/automating-versionadded-changed-markers-in-docs-to-expedite-prs/38423) -- do we want this in 3.14? | ||
- For changes that languish beyond a version cut | ||
- Also for backports? | ||
- Petr says he will build the tooling | ||
- Hugo is the release manager for 3.14 and 3.15 and will integrate it into the release tooling | ||
- Maybe in `blurb release`? | ||
|
||
- [Ned] - don't forget to [register](https://us.pycon.org/2024/registration/category/4) for the [Documentation Summit at PyCon](https://us.pycon.org/2024/events/hatchery/docs-summit/), if you're interested. | ||
|
||
## Next meeting | ||
|
||
The docs team generally meets on the first Tuesday of every month around 19:00-ish UTC. | ||
|
||
We have a recurring Google Calendar event for the meeting. | ||
Let Mariatta know your email address and she can invite you. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters