diff --git a/docs/monthly-meeting/2023-03.md b/docs/monthly-meeting/2023-03.md index 8448987..0715a97 100644 --- a/docs/monthly-meeting/2023-03.md +++ b/docs/monthly-meeting/2023-03.md @@ -8,7 +8,7 @@ - **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). + - 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! diff --git a/docs/monthly-meeting/2023-05.md b/docs/monthly-meeting/2023-05.md index 77a282e..c9c042e 100644 --- a/docs/monthly-meeting/2023-05.md +++ b/docs/monthly-meeting/2023-05.md @@ -64,7 +64,7 @@ Congrats Ned for the [keynote at PyCon US 2023](https://us.pycon.org/2023/about/ * Main benefit: multiple admins instead of single-person bottleneck with Netlify. * [python/cpython#103843](https://github.com/python/cpython/pull/103843) * GH action to update the link from the PR - we don't need one for Netlify - * [JDLH thinks this means] GitHub action to update a link to a documentation preview on ReadTheDocs from the Github Pull Request page. We don't need such a preview for the current docs as published at Netlify. + * [JDLH thinks this means] GitHub action to update a link to a documentation preview on ReadTheDocs from the GitHub Pull Request page. We don't need such a preview for the current docs as published at Netlify. * Example of preview link: Pull Request [#104013, **gh-104010: Separate and improve docs for typing.get_origin and typing.get_args**](https://github.com/python/cpython/pull/104013), contains a link to a preview of the documentation reflecting the Pull Request's effects, at [https://cpython-previews--104013.org.readthedocs.build/en/104013/](https://cpython-previews--104013.org.readthedocs.build/en/104013/). * For moving main docs, a few more things are needed, but they're tracked at the RtD side * We're using a personal account (Mariatta's). Not ideal. Right now community version of RtD doesn't support multiple owners, there are workarounds. Organizations are only in the commercial version so far. @@ -102,7 +102,7 @@ Congrats Ned for the [keynote at PyCon US 2023](https://us.pycon.org/2023/about/ - Manuel: started 3 years ago: have a place to connect with other translators and resources - Julien introduced the tools for translation. - Create channel for translations - - Cristian: It also could be a good idea to have in the main Documentation page (that we will have soon) something like "Wanna help with a translation of these docs? check out this initiatives " + - Cristian: It also could be a good idea to have in the main Documentation page (that we will have soon) something like "Wanna help with a translation of these docs? check out these initiatives " - Ezio: I already brought it up a couple of times, but it would be good to unify the translation infrastructure and tools (see e.g. [python/python-docs-zh-tw#399](https://github.com/python/python-docs-zh-tw/issues/399)) diff --git a/docs/monthly-meeting/2023-09.md b/docs/monthly-meeting/2023-09.md index 3f86b47..77c2bfa 100644 --- a/docs/monthly-meeting/2023-09.md +++ b/docs/monthly-meeting/2023-09.md @@ -90,7 +90,7 @@ Please take a second to read through it! - [CAM] Quick update on reStructured Data - Summary - - Mechanism to extract, process and output structured, machine-readible data from the Python docs + - Mechanism to extract, process and output structured, machine-readable data from the Python docs - Initial focus on deprecations/removals per user requests, then additions/changes and finally other annotations (supported platforms, stable ABI, audit events, etc.) - Output a JSON per version and language for tool and API consumption - Also output tables of all/specific deprecations/removals (or other changes) in the What's New and on a new dedicated Deprecations/Removals page. diff --git a/docs/monthly-meeting/2024-02.md b/docs/monthly-meeting/2024-02.md index fdbec95..f19e2d6 100644 --- a/docs/monthly-meeting/2024-02.md +++ b/docs/monthly-meeting/2024-02.md @@ -54,7 +54,7 @@ Please take a second to read through it! [Ezio] We should also figure out what to do about collapsible sections. [Ned] What problem are collapsible sections solving? Do we have too many examples that users will want to ignore? (In my docs I use tabs, but not collapsible sections) - [Ezio] They allow us to to add more examples inline without making the page too long and more difficult to navigate, but they don't work with non-HTML builders. + [Ezio] They allow us to add more examples inline without making the page too long and more difficult to navigate, but they don't work with non-HTML builders. [Ned] re. pages being too long, we might switch to having a page for each function [Carol] we could run a cron job to count lines diff --git a/docs/monthly-meeting/2024-08.md b/docs/monthly-meeting/2024-08.md index ed15de2..2389b71 100644 --- a/docs/monthly-meeting/2024-08.md +++ b/docs/monthly-meeting/2024-08.md @@ -38,7 +38,7 @@ Please take a second to read through it! - In the last 1-2 months, we've been working on the language and version selector. In the current process this is added at build time from a JSON file, RTD does that at serve time with Javascript so even old versions of the docs link to current versions. - We've been working to not losing what we already have but also not get rid of RTD features. - 3.13 or 3.14 is the version we'll migrate first, to get a feel for the workflow. All other versions will be served by python.org for now. Then we'll migrate one version at a time. - - [Trey] Will this enhance the search? [Manuel] There have been many improvements in RTD search lately. Traditionally RTD overwrites Sphinx search entirely with server-side (Elastic Search) search. Now there's a way to choose RTD or Sphinx search from the docs theme. There's also a person who said they're working on the Sphinx sphinx search engine. + - [Trey] Will this enhance the search? [Manuel] There have been many improvements in RTD search lately. Traditionally RTD overwrites Sphinx search entirely with server-side (Elastic Search) search. Now there's a way to choose RTD or Sphinx search from the docs theme. There's also a person who said they're working on the Sphinx search engine. - [Trey] So there won't be a change on day one. - [Carol] For the PR previews, is there an option to link to the most changed file in the PR? [Manuel] We're working on it, don't know the details. The idea is to perform a diff and determine what changed, and link to it directly. - Issue: [readthedocs/readthedocs.org#11319](https://github.com/readthedocs/readthedocs.org/issues/11319) diff --git a/docs/monthly-meeting/2024-09.md b/docs/monthly-meeting/2024-09.md index 34513df..bdb4d0e 100644 --- a/docs/monthly-meeting/2024-09.md +++ b/docs/monthly-meeting/2024-09.md @@ -18,18 +18,18 @@ Please take a second to read through it! (Name / `@GitHubUsername` *[/ Discord, if different]*) -- Daniele Procida / @EvilDMP -- Hugo van Kemenade / @hugovk -- Trey / @treyhunner +- Daniele Procida / `@EvilDMP` +- Hugo van Kemenade / `@hugovk` +- Trey / `@treyhunner` - Manuel / `@humitos` -- Melissa / @melissawm -- Petr Viktorin / @encukou +- Melissa / `@melissawm` +- Petr Viktorin / `@encukou` - Ryan / `@ryan-duve` ## Discussion - [Hugo] - - As a RM, logged into the docs server, and fixed a bunch of stopped jobs + - As an RM, logged into the docs server, and fixed a bunch of stopped jobs - It would be nice to have 2 cron jobs -- one for HTML (fast), one for PDFs (slow) - We have a bus factor for the repo; only 2 active people; we should give access to more people & we should give Adam access to the build server - Separately, we want to move HTML to Read the Docs, while keeping the ability to build them separately diff --git a/docs/monthly-meeting/2024-10.md b/docs/monthly-meeting/2024-10.md index 960f394..345379e 100644 --- a/docs/monthly-meeting/2024-10.md +++ b/docs/monthly-meeting/2024-10.md @@ -134,7 +134,7 @@ to read through it! -- people can start where they need, depending on how much handholding they need etc. - [Mariatta] Maybe the first quiz should be “what kind of a learner are you”? - - [Carol] Moving away from the tooling: I thing there's a subset of users that use + - [Carol] Moving away from the tooling: I think there's a subset of users that use the current Python tutorial, others use different ones - Carpentries, ones from the scientific ecosystem, Dr.Chuck, Chicago[???], etc. The Carpentries have done a great job in the past decade coming up with learning-theory-based tutorials: diff --git a/docs/monthly-meeting/2024-11.md b/docs/monthly-meeting/2024-11.md index f7aa1ee..2a428a0 100644 --- a/docs/monthly-meeting/2024-11.md +++ b/docs/monthly-meeting/2024-11.md @@ -23,13 +23,13 @@ to read through it! (Name / `@GitHubUsername` _[/ Discord, if different]_) -- Hugo van Kemenade / @hugovk +- Hugo van Kemenade / `@hugovk` - Mariatta - Joe - Ned Batchelder / `@nedbat` - Trey - Daniele -- Ryan / `ryan-duve` +- Ryan / `@ryan-duve` - Petr / `@encukou` ## Introductions