Skip to content

Add June 2025 meeting notes #158

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add June 2025 meeting notes #158

wants to merge 1 commit into from

Conversation

hugovk
Copy link
Member

@hugovk hugovk commented Jun 13, 2025


📚 Documentation preview 📚: https://docs-community--158.org.readthedocs.build/

[Adam]: I did go through and get a list of issues re: how our model differs from RtD
expectations, I might have another go at figuring out how to reconcile the approaches.

[Carol]: We need to involve the relevant people - Manuel, Adam, Petr, release managers,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi 👋🏼 , I'm Manuel from Read the Docs and I just saw this comment here. I wasn't being able to participate in the meetings lately, but I've been reading all these notes. So, here I am 😄

We made some progress some time ago with Hugo, Carol and other folks. Currently there is a CPython project that builds the previews every time a push is done:

It makes usage of the Read the Docs Addons API through this file https://github.com/python/cpython/blob/f0799795994bfd9ab0740c4d70ac54270991ba47/Doc/tools/static/rtd_switcher.js to generate the version and language selectors.

Besides, we did some tests with the Spanish translation as well:

We've also enabled some cool features like "Visual Diff" that shows the differences between the PR and the default version of the docs and lists of all the files that were changed. Here you have a small example https://cpython-previews--134377.org.readthedocs.build/en/134377/library/dataclasses.html?readthedocs-diff=true&readthedocs-diff-chunk=4

Screenshot_2025-06-16_16-58-08

All these conversations happened in Discord under the #infra channel inside a thread named RTD for the Python docs. Feel free to ping me here or there if you want to continue this conversation in case of clarification of any doubts or coordination ❤️

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants