Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add notes from May #115

Merged
merged 2 commits into from
May 19, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
84 changes: 84 additions & 0 deletions docs/monthly-meeting/2024-05.md
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
- Erlend
hugovk marked this conversation as resolved.
Show resolved Hide resolved


## 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.
hugovk marked this conversation as resolved.
Show resolved Hide resolved
- 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/
hugovk marked this conversation as resolved.
Show resolved Hide resolved
- 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.
1 change: 1 addition & 0 deletions docs/monthly-meeting/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -38,3 +38,4 @@ Monthly reports in chronological order.
Feb 2024 <2024-02.md>
Mar 2024 <2024-03.md>
Apr 2024 <2024-04.md>
May 2024 <2024-05.md>
Loading