-
-
Notifications
You must be signed in to change notification settings - Fork 26
Add notes from May #115
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
Merged
Merged
Add notes from May #115
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or 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 | ||
- Erlend | ||
|
||
|
||
## 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. |
This file contains hidden or 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
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.