diff --git a/docs/monthly-meeting/2024-02.md b/docs/monthly-meeting/2024-02.md index 911559e..fdbec95 100644 --- a/docs/monthly-meeting/2024-02.md +++ b/docs/monthly-meeting/2024-02.md @@ -29,7 +29,7 @@ Please take a second to read through it! ## Reports and celebrations -- [Hugo] ๐ŸŽ‰ Since we started fixing the 8,212 Sphinx reference warnings, with 136 PRs + 220 backports we've fixed 56% of them in total (now at 3,574) and 61% of them in `Doc/`. The `.nitignore` initially listed 299 files with warnings; 67% have been fixed, with 100 remaining. ๐Ÿงน๐Ÿ“š https://discuss.python.org/t/broken-references-in-sphinx-docs/19463/7 +- [Hugo] ๐ŸŽ‰ Since we started fixing the 8,212 Sphinx reference warnings, with 136 PRs + 220 backports we've fixed 56% of them in total (now at 3,574) and 61% of them in `Doc/`. The `.nitignore` initially listed 299 files with warnings; 67% have been fixed, with 100 remaining. ๐Ÿงน๐Ÿ“š [discuss.python.org/t/broken-references-in-sphinx-docs/19463/7](https://discuss.python.org/t/broken-references-in-sphinx-docs/19463/7) - [Hugo] Accessibility improvement. Underlining links in recent docs. @@ -72,7 +72,7 @@ Please take a second to read through it! [Hugo] To begin with we could only put HTML there. The only thing we'd need is to redo the version switcher. On RTD they have the fly-out switcher menu, maybe that could be re-styled; Manuel seemed keen to work on that. -- [Carol] Improving clarity around HOWTO docs: https://github.com/python/cpython/issues/114976 +- [Carol] Improving clarity around HOWTO docs: [python/cpython#114976](https://github.com/python/cpython/issues/114976) [CAM] Could you explain what the older-style howtos were? [Carol] It goes back to Linux in the early days, when docs were scarce. Howtos were architecture discussions of how something was implemented, more like background on a topic -- explanations in Diรกtaxis terms diff --git a/docs/monthly-meeting/2024-04.md b/docs/monthly-meeting/2024-04.md index 35eda73..81bc458 100644 --- a/docs/monthly-meeting/2024-04.md +++ b/docs/monthly-meeting/2024-04.md @@ -29,10 +29,10 @@ Please take a second to read through it! ## Reports and celebrations -- [Carol] Docs summit at PyCon US https://us.pycon.org/2024/events/hatchery/docs-summit/ +- [Carol] Docs summit at PyCon US [us.pycon.org/2024/events/hatchery/docs-summit/](https://us.pycon.org/2024/events/hatchery/docs-summit/) - [Hugo] Modernised font on macOS: [python/python-docs-theme#176](https://github.com/python/python-docs-theme/pull/176) -- [Hugo] I wrote up how to activate tabs in Sphinx docs based on the reader's OS: https://dev.to/hugovk/sphinx-docs-how-to-activate-tabs-for-your-os-pd3 -- [Hugo] Python 3.11 is now only accepting security fixes, so very few docs PRs need backporting: https://devguide.python.org/versions/ +- [Hugo] I wrote up how to activate tabs in Sphinx docs based on the reader's OS: [dev.to/hugovk/sphinx-docs-how-to-activate-tabs-for-your-os-pd3](https://dev.to/hugovk/sphinx-docs-how-to-activate-tabs-for-your-os-pd3) +- [Hugo] Python 3.11 is now only accepting security fixes, so very few docs PRs need backporting: [devguide.python.org/versions/](https://devguide.python.org/versions/) ## Discussion @@ -42,13 +42,13 @@ No use cases other than "grepping it all" found so far. ### [CAM] WarningMessage is undocumented -https://discuss.python.org/t/warningmessage-is-undocumented/48877 +[discuss.python.org/t/warningmessage-is-undocumented/48877](https://discuss.python.org/t/warningmessage-is-undocumented/48877) Please read the thread and chime in! ### Parameter annotations: `int | float` or `int or float`? -https://discuss.python.org/t/how-should-we-mark-up-multiple-types-in-a-type-field/48196 +[discuss.python.org/t/how-should-we-mark-up-multiple-types-in-a-type-field/48196](https://discuss.python.org/t/how-should-we-mark-up-multiple-types-in-a-type-field/48196) ## Next meeting