Documentation Community Team Meeting (April 2, 2024)¶
Roll call¶
(Name / @GitHubUsername [/ Discord, if different])
Petr Viktorin /
@encukouHugo van Kemenade /
@hugovkDaniele
Carol /
@willingcNed /
@nedbatCAM /
@CAM-GerlachBradley
Ashley /
@AWhetter
Reports and celebrations¶
[Carol] Docs summit at PyCon US us.pycon.org/2024/events/hatchery/docs-summit/
[Hugo] Modernised font on macOS: python/python-docs-theme#176
[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
[Hugo] Python 3.11 is now only accepting security fixes, so very few docs PRs need backporting: devguide.python.org/versions/
Discussion¶
Changelog splitting/reduction¶
No use cases other than “grepping it all” found so far.
[CAM] WarningMessage is undocumented¶
discuss.python.org/t/warningmessage-is-undocumented/48877
Please read the thread and chime in!
Parameter annotations: int | float or int or float?¶
discuss.python.org/t/how-should-we-mark-up-multiple-types-in-a-type-field/48196