Skip to content

Commit

Permalink
Make links clickable in 2024 minutes
Browse files Browse the repository at this point in the history
  • Loading branch information
hugovk committed Jul 31, 2024
1 parent f843511 commit ee011f2
Show file tree
Hide file tree
Showing 2 changed files with 7 additions and 7 deletions.
4 changes: 2 additions & 2 deletions docs/monthly-meeting/2024-02.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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
Expand Down
10 changes: 5 additions & 5 deletions docs/monthly-meeting/2024-04.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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

Expand Down

0 comments on commit ee011f2

Please sign in to comment.