From 92277b7eccdc5f796a2ca604b19d1748b6074d4b Mon Sep 17 00:00:00 2001 From: egeakman Date: Fri, 22 Sep 2023 01:17:16 +0300 Subject: [PATCH 01/13] Add meeting notes from September --- docs/monthly-meeting/2023-09.md | 118 ++++++++++++++++++++++++++++++++ docs/monthly-meeting/index.rst | 1 + 2 files changed, 119 insertions(+) create mode 100644 docs/monthly-meeting/2023-09.md diff --git a/docs/monthly-meeting/2023-09.md b/docs/monthly-meeting/2023-09.md new file mode 100644 index 0000000..8c0ab5d --- /dev/null +++ b/docs/monthly-meeting/2023-09.md @@ -0,0 +1,118 @@ +# Documentation Community Team Meeting (September 2023) + +- **Date:** 2023-09-05 +- **Time:** [19:00 UTC](https://arewemeetingyet.com/UTC/2023-09-05/19:00/Docs%20Meeting) +- **This HackMD:** https://hackmd.io/@encukou/pydocswg1 +- [**Discourse thread**](https://discuss.python.org/t/32355) (for September) +- [**Meeting reports**](https://docs-community.readthedocs.io/en/latest/monthly-meeting/index.html) (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) +- CAM Gerlach / `@CAM-Gerlach` +- Daniele / `@EvilDMP` +- Petr Viktorin / `@encukou` +- Adam Turner / ``@AA-Turner`` +- Hugo van Kemenade / ``@hugovk`` +- Maciej Olko / `@m-aciek` / `@m_aciek` +- Ryan / `@ryan-duve` +- Marcus Sherman / `@betteridiot` +- Erlend / `@erlend-aasland` +- Ege Akman / `@egeakman` +- Ezio + + +## Introductions + +- Maciej, from Poland, works on Polish translation + + +## Reports and celebrations + +- [Hugo] https://docs.python.org now has a dark theme! ๐ŸŒ’ + +- [Hugo] Little things can be big things: I added a shortcut at the top of the [datetime](https://docs.python.org/3/library/datetime.html) docs to take you directly to the percent formatting codes. [People are happy!](https://mastodon.social/@hugovk/110951423574144386) + +- [Adam] Six releases of [Sphinx](https://www.sphinx-doc.org/en/master/changes.html)! + +- [Adam] New PEP helper & validator ([``check-peps.py``](https://github.com/python/peps/commit/814ceede975056cc56a019bbed62b29a6a875830)) + +- [Adam] [Datamodel headings](https://github.com/python/cpython/pull/108146) for readability + +- [Adam] Work to [remove references to Distutils](https://github.com/python/cpython/issues/92584) in the documentation ahead of the 3.12.0 release + + +## Discussion + +- [Hugo] python-docs-theme: + - Need a release of 2023.8 to fix some dark theme bugs: [python/python-docs-theme#152](https://github.com/python/python-docs-theme/issues/152) + - Have a PR ready to release using Trusted Publishers, need someone to set it up on PyPI: [python/python-docs-theme#148](https://github.com/python/python-docs-theme/pull/148) + - These are both waiting on people who can make releases. Adam: should we review the group of people who can make releases, and look to expand it? Potentially ties in to a [Python organisation](https://github.com/python/steering-council/issues/207) on PyPI. + + +- [Ege/Hugo/CAM] Updates and discussion on Plausible hosting: + - PSF folks opposed to self-hosting + - Paid hosting is a *little* expensive + - We got a 15% discount from them, which would be \$1400-\$1500 yearly + - People brought up several motivating use cases already for this, including: + - Translation prioritization for languages/pages + - Automated translations + - Determine how many people use backported branches + - Determining if old pages are still needed/used + - Potentially determine common broken links, maybe even fragment ids? + - Prioritisation for documentation + - [Previous Core Development budget thread](https://discuss.python.org/t/23507) + - Next steps: CAM to write to Deb from the PSF with a summary of this discussion + +- [Maciej] Translations platform โ€“ trying to initiate discussion ([Discourse thread](https://discuss.python.org/t/docs-translation-platform/29940)) + - Transifex has cut off shared memory (between projects) for open source tier, Rafael from Brazilian Portugese team implemented a workaround + - Weblate โ€“ based on Django, open license, used by PyPI + - The POC of Python docs translations/Weblate integration is functional, I'm working on improving it + - Python docs don't fit into free open source tier on Weblate โ€“ the initial proposition is 1500โ‚ฌ/year (50% discount) + - There is an option to self-host a Weblate instance + - (Both platforms support using machine learning translation tools) + +- [Ege] New bootstrapper for starting new Python docs translations + - Issues with the [current tool](https://github.com/JulienPalard/python-docs-cookiecutter): + - Unmaintained / inactive + - Uses third-party modules + - Add a link from the [DevGuide](https://devguide.python.org/documentation/translating/#starting-a-new-translation) to this [repository](https://github.com/egeakman/python-docs-bootstrapper) + - [PEP 545](https://peps.python.org/pep-0545/#repository-for-po-files) mentions the per-language repositories for ``.po`` files + +- [CAM] Quick update on reStructured Data + - Summary + - Mechanism to extract, process and output structured, machine-readible 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 a table of all deprecations/removals (or other changes) in the + - Progress + - Further considerable work on design document, schema, etc. + - Developed initial working implementation and prototyped/tested most planned features + - Discussed current approach at some length with @AA-Turner and currently making some significant changes based on his feedback + - Next steps: Re-scoping to focus on the basic features needed + - Learn more + - [HackMD detailed design document and schema](https://hackmd.io/jF8awEd3TuKh1Ia5Hqa_8g?both#TransformsProcessors) + - [Initial working prototype implementation](https://github.com/python/cpython/compare/main...CAM-Gerlach:cpython:add-structured-deprecation-support) + +- [Hugo] Python 3.12.0 is out on 2023-10-02! Any finishing touches needed for [Whatโ€™s New In Python 3.12](https://docs.python.org/3.12/whatsnew/3.12.html)? + - [CAM] Was planning to finish this at the core dev sprints, but didn't realize the final release date was so much earlier than last year + - [CAM] Wanted to be able to use the new reStructured Data directive to list deprecations, removals, additions and changes in the appropriate places following the existing format, but too late for that now + - [CAM] May be able to use it to help guide the process, but timeline is going to be tight + +- [Daniele] How much appetite/consensus is there for an iterative workflow? [Discussion in Discord](https://discord.com/channels/935215565872693329/935215566334079058/1138743377962225794) + - Daniele can adapt the Discord messages into a Discourse thread and post that for further feedback and consensus + + +## Next meeting + +The docs team generally meets on the first Tuesday of every month. + +We have a recurring Google Calendar event for the meeting. Let Mariatta know your email address and she can invite you. diff --git a/docs/monthly-meeting/index.rst b/docs/monthly-meeting/index.rst index 25fc37d..4e7fec7 100644 --- a/docs/monthly-meeting/index.rst +++ b/docs/monthly-meeting/index.rst @@ -30,3 +30,4 @@ Monthly reports in reverse chronological order. Jun 2023 <2023-06.md> Jul 2023 <2023-07.md> Aug 2023 <2023-08.md> + Sep 2023 <2023-09.md> From fdc25078bd47d22a45149193a285d0fb2adc231c Mon Sep 17 00:00:00 2001 From: Ege Akman Date: Fri, 22 Sep 2023 01:26:33 +0300 Subject: [PATCH 02/13] Fix link --- docs/monthly-meeting/2023-09.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/monthly-meeting/2023-09.md b/docs/monthly-meeting/2023-09.md index 8c0ab5d..3b99dfd 100644 --- a/docs/monthly-meeting/2023-09.md +++ b/docs/monthly-meeting/2023-09.md @@ -99,7 +99,7 @@ Please take a second to read through it! - Discussed current approach at some length with @AA-Turner and currently making some significant changes based on his feedback - Next steps: Re-scoping to focus on the basic features needed - Learn more - - [HackMD detailed design document and schema](https://hackmd.io/jF8awEd3TuKh1Ia5Hqa_8g?both#TransformsProcessors) + - [HackMD detailed design document and schema](https://hackmd.io/jF8awEd3TuKh1Ia5Hqa_8g?view#TransformsProcessors) - [Initial working prototype implementation](https://github.com/python/cpython/compare/main...CAM-Gerlach:cpython:add-structured-deprecation-support) - [Hugo] Python 3.12.0 is out on 2023-10-02! Any finishing touches needed for [Whatโ€™s New In Python 3.12](https://docs.python.org/3.12/whatsnew/3.12.html)? From 22073f3676b2a5bca2bdd2e8f57e8fccbf8d1ab4 Mon Sep 17 00:00:00 2001 From: egeakman Date: Fri, 22 Sep 2023 01:41:41 +0300 Subject: [PATCH 03/13] Add HackMD anchors to linkcheck ignore list --- docs/conf.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/conf.py b/docs/conf.py index 8e117dd..32e4930 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -48,4 +48,6 @@ r"https://[a-zA-Z0-9.-]+\.org\.readthedocs\.build/[a-zA-Z0-9.-]+/[a-zA-Z0-9.-]+/", # Deleted Plausible page: r"https://plausible\.io/share/hugovk-cpython\.readthedocs\.io\?auth=XDF9fK3EB2dEHCr4sC9hn", + # HackMD anchors: + r"https://hackmd\.io/[^?]+\?[^#]+#.+" ] From 607e4998263f85db5425c2d219257e3feb28f741 Mon Sep 17 00:00:00 2001 From: egeakman Date: Fri, 22 Sep 2023 01:55:00 +0300 Subject: [PATCH 04/13] black --- docs/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/conf.py b/docs/conf.py index 32e4930..14e464e 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -49,5 +49,5 @@ # Deleted Plausible page: r"https://plausible\.io/share/hugovk-cpython\.readthedocs\.io\?auth=XDF9fK3EB2dEHCr4sC9hn", # HackMD anchors: - r"https://hackmd\.io/[^?]+\?[^#]+#.+" + r"https://hackmd\.io/[^?]+\?[^#]+#.+", ] From 5acaee56e4d736425f2b8ac5ad789729f0a8d8d7 Mon Sep 17 00:00:00 2001 From: egeakman Date: Fri, 22 Sep 2023 14:10:25 +0300 Subject: [PATCH 05/13] Fix whitespace --- docs/monthly-meeting/2023-09.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/monthly-meeting/2023-09.md b/docs/monthly-meeting/2023-09.md index 3b99dfd..3c0c5c2 100644 --- a/docs/monthly-meeting/2023-09.md +++ b/docs/monthly-meeting/2023-09.md @@ -1,7 +1,7 @@ # Documentation Community Team Meeting (September 2023) - **Date:** 2023-09-05 -- **Time:** [19:00 UTC](https://arewemeetingyet.com/UTC/2023-09-05/19:00/Docs%20Meeting) +- **Time:** [19:00 UTC](https://arewemeetingyet.com/UTC/2023-09-05/19:00/Docs%20Meeting) - **This HackMD:** https://hackmd.io/@encukou/pydocswg1 - [**Discourse thread**](https://discuss.python.org/t/32355) (for September) - [**Meeting reports**](https://docs-community.readthedocs.io/en/latest/monthly-meeting/index.html) (the latest one might be an [**unmerged PR**](https://github.com/python/docs-community/pulls)) @@ -37,7 +37,7 @@ Please take a second to read through it! ## Reports and celebrations -- [Hugo] https://docs.python.org now has a dark theme! ๐ŸŒ’ +- [Hugo] https://docs.python.org now has a dark theme! ๐ŸŒ’ - [Hugo] Little things can be big things: I added a shortcut at the top of the [datetime](https://docs.python.org/3/library/datetime.html) docs to take you directly to the percent formatting codes. [People are happy!](https://mastodon.social/@hugovk/110951423574144386) @@ -47,7 +47,7 @@ Please take a second to read through it! - [Adam] [Datamodel headings](https://github.com/python/cpython/pull/108146) for readability -- [Adam] Work to [remove references to Distutils](https://github.com/python/cpython/issues/92584) in the documentation ahead of the 3.12.0 release +- [Adam] Work to [remove references to Distutils](https://github.com/python/cpython/issues/92584) in the documentation ahead of the 3.12.0 release ## Discussion @@ -92,7 +92,7 @@ Please take a second to read through it! - Mechanism to extract, process and output structured, machine-readible 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 a table of all deprecations/removals (or other changes) in the + - Also output a table of all deprecations/removals (or other changes) in the - Progress - Further considerable work on design document, schema, etc. - Developed initial working implementation and prototyped/tested most planned features From 6a205a12eb0bb6cff929174dd3c6499e749b58fb Mon Sep 17 00:00:00 2001 From: Ege Akman Date: Sat, 23 Sep 2023 21:35:06 +0300 Subject: [PATCH 06/13] Apply suggestions from code review Co-authored-by: Ezio Melotti --- docs/monthly-meeting/2023-09.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/monthly-meeting/2023-09.md b/docs/monthly-meeting/2023-09.md index 3c0c5c2..60165a3 100644 --- a/docs/monthly-meeting/2023-09.md +++ b/docs/monthly-meeting/2023-09.md @@ -20,14 +20,14 @@ Please take a second to read through it! - CAM Gerlach / `@CAM-Gerlach` - Daniele / `@EvilDMP` - Petr Viktorin / `@encukou` -- Adam Turner / ``@AA-Turner`` -- Hugo van Kemenade / ``@hugovk`` +- Adam Turner / `@AA-Turner` +- Hugo van Kemenade / `@hugovk` - Maciej Olko / `@m-aciek` / `@m_aciek` - Ryan / `@ryan-duve` - Marcus Sherman / `@betteridiot` - Erlend / `@erlend-aasland` - Ege Akman / `@egeakman` -- Ezio +- Ezio Melotti / `@ezio-melotti` ## Introductions @@ -37,13 +37,13 @@ Please take a second to read through it! ## Reports and celebrations -- [Hugo] https://docs.python.org now has a dark theme! ๐ŸŒ’ +- [Hugo] [docs.python.org](https://docs.python.org) now has a dark theme! ๐ŸŒ’ - [Hugo] Little things can be big things: I added a shortcut at the top of the [datetime](https://docs.python.org/3/library/datetime.html) docs to take you directly to the percent formatting codes. [People are happy!](https://mastodon.social/@hugovk/110951423574144386) - [Adam] Six releases of [Sphinx](https://www.sphinx-doc.org/en/master/changes.html)! -- [Adam] New PEP helper & validator ([``check-peps.py``](https://github.com/python/peps/commit/814ceede975056cc56a019bbed62b29a6a875830)) +- [Adam] New PEP helper & validator ([`check-peps.py`](https://github.com/python/peps/commit/814ceede975056cc56a019bbed62b29a6a875830)) - [Adam] [Datamodel headings](https://github.com/python/cpython/pull/108146) for readability @@ -96,7 +96,7 @@ Please take a second to read through it! - Progress - Further considerable work on design document, schema, etc. - Developed initial working implementation and prototyped/tested most planned features - - Discussed current approach at some length with @AA-Turner and currently making some significant changes based on his feedback + - Discussed current approach at some length with `@AA-Turner` and currently making some significant changes based on his feedback - Next steps: Re-scoping to focus on the basic features needed - Learn more - [HackMD detailed design document and schema](https://hackmd.io/jF8awEd3TuKh1Ia5Hqa_8g?view#TransformsProcessors) From 312d04983ebe34e66116943c58ca582edf07fe7f Mon Sep 17 00:00:00 2001 From: Ege Akman Date: Sat, 23 Sep 2023 22:32:04 +0300 Subject: [PATCH 07/13] Update docs/monthly-meeting/2023-09.md Co-authored-by: Ezio Melotti --- docs/monthly-meeting/2023-09.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/monthly-meeting/2023-09.md b/docs/monthly-meeting/2023-09.md index 60165a3..467d40f 100644 --- a/docs/monthly-meeting/2023-09.md +++ b/docs/monthly-meeting/2023-09.md @@ -84,7 +84,7 @@ Please take a second to read through it! - Issues with the [current tool](https://github.com/JulienPalard/python-docs-cookiecutter): - Unmaintained / inactive - Uses third-party modules - - Add a link from the [DevGuide](https://devguide.python.org/documentation/translating/#starting-a-new-translation) to this [repository](https://github.com/egeakman/python-docs-bootstrapper) + - Add a link from the [devguide](https://devguide.python.org/documentation/translating/#starting-a-new-translation) to this [repository](https://github.com/egeakman/python-docs-bootstrapper) - [PEP 545](https://peps.python.org/pep-0545/#repository-for-po-files) mentions the per-language repositories for ``.po`` files - [CAM] Quick update on reStructured Data From 624998a9fe7e3d0bd1ec47a737510530f4be760b Mon Sep 17 00:00:00 2001 From: Ege Akman Date: Sat, 23 Sep 2023 22:37:08 +0300 Subject: [PATCH 08/13] Update docs/monthly-meeting/2023-09.md Co-authored-by: Ezio Melotti --- docs/monthly-meeting/2023-09.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/monthly-meeting/2023-09.md b/docs/monthly-meeting/2023-09.md index 467d40f..fe67c43 100644 --- a/docs/monthly-meeting/2023-09.md +++ b/docs/monthly-meeting/2023-09.md @@ -85,7 +85,7 @@ Please take a second to read through it! - Unmaintained / inactive - Uses third-party modules - Add a link from the [devguide](https://devguide.python.org/documentation/translating/#starting-a-new-translation) to this [repository](https://github.com/egeakman/python-docs-bootstrapper) - - [PEP 545](https://peps.python.org/pep-0545/#repository-for-po-files) mentions the per-language repositories for ``.po`` files + - [PEP 545](https://peps.python.org/pep-0545/#repository-for-po-files) mentions the per-language repositories for `.po` files - [CAM] Quick update on reStructured Data - Summary From e5a9513176849ac76ab0b9cbfcf808f7c96ba09e Mon Sep 17 00:00:00 2001 From: Ege Akman Date: Sat, 23 Sep 2023 22:39:41 +0300 Subject: [PATCH 09/13] Update docs/monthly-meeting/2023-09.md Co-authored-by: C.A.M. Gerlach --- docs/monthly-meeting/2023-09.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/monthly-meeting/2023-09.md b/docs/monthly-meeting/2023-09.md index fe67c43..2f13a79 100644 --- a/docs/monthly-meeting/2023-09.md +++ b/docs/monthly-meeting/2023-09.md @@ -92,7 +92,7 @@ Please take a second to read through it! - Mechanism to extract, process and output structured, machine-readible 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 a table of all deprecations/removals (or other changes) in the + - Also output tables of all/specific deprecations/removals (or other changes) in the What's New and on a new dedicated Deprecations/Removals page. - Progress - Further considerable work on design document, schema, etc. - Developed initial working implementation and prototyped/tested most planned features From cecb0434769daaf9a1632779b5346946447f51ba Mon Sep 17 00:00:00 2001 From: Ege Akman Date: Sun, 24 Sep 2023 20:08:32 +0300 Subject: [PATCH 10/13] Apply suggestions from code review Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> --- docs/monthly-meeting/2023-09.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/monthly-meeting/2023-09.md b/docs/monthly-meeting/2023-09.md index 2f13a79..fc8a1c4 100644 --- a/docs/monthly-meeting/2023-09.md +++ b/docs/monthly-meeting/2023-09.md @@ -18,14 +18,14 @@ Please take a second to read through it! (Name / `@GitHubUsername` / Discord if different) - CAM Gerlach / `@CAM-Gerlach` -- Daniele / `@EvilDMP` +- Daniele Procida / `@EvilDMP` - Petr Viktorin / `@encukou` - Adam Turner / `@AA-Turner` - Hugo van Kemenade / `@hugovk` - Maciej Olko / `@m-aciek` / `@m_aciek` -- Ryan / `@ryan-duve` +- Ryan Duve / `@ryan-duve` - Marcus Sherman / `@betteridiot` -- Erlend / `@erlend-aasland` +- Erlend Aasland / `@erlend-aasland` - Ege Akman / `@egeakman` - Ezio Melotti / `@ezio-melotti` @@ -37,7 +37,7 @@ Please take a second to read through it! ## Reports and celebrations -- [Hugo] [docs.python.org](https://docs.python.org) now has a dark theme! ๐ŸŒ’ +- [Hugo] [docs.python.org](https://docs.python.org/3/) now has a dark theme! ๐ŸŒ’ - [Hugo] Little things can be big things: I added a shortcut at the top of the [datetime](https://docs.python.org/3/library/datetime.html) docs to take you directly to the percent formatting codes. [People are happy!](https://mastodon.social/@hugovk/110951423574144386) @@ -96,7 +96,7 @@ Please take a second to read through it! - Progress - Further considerable work on design document, schema, etc. - Developed initial working implementation and prototyped/tested most planned features - - Discussed current approach at some length with `@AA-Turner` and currently making some significant changes based on his feedback + - Discussed current approach at some length with Adam and currently making some significant changes based on his feedback - Next steps: Re-scoping to focus on the basic features needed - Learn more - [HackMD detailed design document and schema](https://hackmd.io/jF8awEd3TuKh1Ia5Hqa_8g?view#TransformsProcessors) From c97f901a5f97ee511a882aa047219686b290ba2d Mon Sep 17 00:00:00 2001 From: egeakman Date: Sun, 24 Sep 2023 21:08:32 +0300 Subject: [PATCH 11/13] Add next steps --- docs/monthly-meeting/2023-09.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/monthly-meeting/2023-09.md b/docs/monthly-meeting/2023-09.md index fc8a1c4..2ef6510 100644 --- a/docs/monthly-meeting/2023-09.md +++ b/docs/monthly-meeting/2023-09.md @@ -79,12 +79,13 @@ Please take a second to read through it! - Python docs don't fit into free open source tier on Weblate โ€“ the initial proposition is 1500โ‚ฌ/year (50% discount) - There is an option to self-host a Weblate instance - (Both platforms support using machine learning translation tools) + - Next steps: Contact the PSF with assistance from CAM - [Ege] New bootstrapper for starting new Python docs translations - Issues with the [current tool](https://github.com/JulienPalard/python-docs-cookiecutter): - Unmaintained / inactive - Uses third-party modules - - Add a link from the [devguide](https://devguide.python.org/documentation/translating/#starting-a-new-translation) to this [repository](https://github.com/egeakman/python-docs-bootstrapper) + - Next steps: Add a link from the [devguide](https://devguide.python.org/documentation/translating/#starting-a-new-translation) to this [repository](https://github.com/egeakman/python-docs-bootstrapper) - [PEP 545](https://peps.python.org/pep-0545/#repository-for-po-files) mentions the per-language repositories for `.po` files - [CAM] Quick update on reStructured Data From 828055e5ab02d5f4bf159654f6096783b8ad7746 Mon Sep 17 00:00:00 2001 From: egeakman Date: Mon, 25 Sep 2023 22:42:22 +0300 Subject: [PATCH 12/13] Suggestions --- docs/monthly-meeting/2023-09.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/monthly-meeting/2023-09.md b/docs/monthly-meeting/2023-09.md index 2ef6510..afbccf1 100644 --- a/docs/monthly-meeting/2023-09.md +++ b/docs/monthly-meeting/2023-09.md @@ -86,7 +86,6 @@ Please take a second to read through it! - Unmaintained / inactive - Uses third-party modules - Next steps: Add a link from the [devguide](https://devguide.python.org/documentation/translating/#starting-a-new-translation) to this [repository](https://github.com/egeakman/python-docs-bootstrapper) - - [PEP 545](https://peps.python.org/pep-0545/#repository-for-po-files) mentions the per-language repositories for `.po` files - [CAM] Quick update on reStructured Data - Summary @@ -109,7 +108,7 @@ Please take a second to read through it! - [CAM] May be able to use it to help guide the process, but timeline is going to be tight - [Daniele] How much appetite/consensus is there for an iterative workflow? [Discussion in Discord](https://discord.com/channels/935215565872693329/935215566334079058/1138743377962225794) - - Daniele can adapt the Discord messages into a Discourse thread and post that for further feedback and consensus + - Petr and Daniele can adapt the Discord messages into a Discourse thread and post that for further feedback and consensus ## Next meeting From d1d6a0da13471ac79495e2bf31a6a5ba130fb258 Mon Sep 17 00:00:00 2001 From: egeakman Date: Mon, 25 Sep 2023 23:24:58 +0300 Subject: [PATCH 13/13] Clarify budget thread link --- docs/monthly-meeting/2023-09.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/monthly-meeting/2023-09.md b/docs/monthly-meeting/2023-09.md index afbccf1..6778595 100644 --- a/docs/monthly-meeting/2023-09.md +++ b/docs/monthly-meeting/2023-09.md @@ -69,7 +69,8 @@ Please take a second to read through it! - Determining if old pages are still needed/used - Potentially determine common broken links, maybe even fragment ids? - Prioritisation for documentation - - [Previous Core Development budget thread](https://discuss.python.org/t/23507) + - If the budget is available, why not use it? + - [Previous Core Development budget thread](https://discuss.python.org/t/23507) - Next steps: CAM to write to Deb from the PSF with a summary of this discussion - [Maciej] Translations platform โ€“ trying to initiate discussion ([Discourse thread](https://discuss.python.org/t/docs-translation-platform/29940))