Skip to content

Commit

Permalink
Update how minutes archive is displayed
Browse files Browse the repository at this point in the history
  • Loading branch information
StanFromIreland committed Nov 24, 2024
1 parent 96e6c5c commit 6c8c758
Show file tree
Hide file tree
Showing 8 changed files with 15 additions and 15 deletions.
2 changes: 1 addition & 1 deletion docs/monthly-meeting/2023-03.md
Original file line number Diff line number Diff line change
Expand Up @@ -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!
Expand Down
4 changes: 2 additions & 2 deletions docs/monthly-meeting/2023-05.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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 <list of languages here>"
- 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 <list of languages here>"
- 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))


Expand Down
2 changes: 1 addition & 1 deletion docs/monthly-meeting/2023-09.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
2 changes: 1 addition & 1 deletion docs/monthly-meeting/2024-02.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/monthly-meeting/2024-08.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
12 changes: 6 additions & 6 deletions docs/monthly-meeting/2024-09.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/monthly-meeting/2024-10.md
Original file line number Diff line number Diff line change
Expand Up @@ -134,7 +134,7 @@ to read through it!
<https://en.wikipedia.org/wiki/Learning_pathway> -- 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:
Expand Down
4 changes: 2 additions & 2 deletions docs/monthly-meeting/2024-11.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down

0 comments on commit 6c8c758

Please sign in to comment.