Skip to content

Commit

Permalink
Merge pull request #114 from encukou/2024-04
Browse files Browse the repository at this point in the history
  • Loading branch information
hugovk authored May 7, 2024
2 parents 74cf8b0 + 40b23c7 commit a7a48bf
Show file tree
Hide file tree
Showing 2 changed files with 59 additions and 0 deletions.
58 changes: 58 additions & 0 deletions docs/monthly-meeting/2024-04.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# Documentation Community Team Meeting (April 2024)

- **Date:** 2024-04-02
- **Time:** [19:00 UTC](https://arewemeetingyet.com/UTC/2024-04-02/19:00/Docs%20Meeting)
- **This HackMD:** https://hackmd.io/@encukou/pydocswg1
- [**Discourse thread**](https://discuss.python.org/t/49574) (for April)
- [**Meeting reports**](https://docs-community.readthedocs.io/en/latest/monthly-meeting/) (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]*)

- Petr Viktorin / `@encukou`
- Hugo van Kemenade / `hugovk`
- Daniele
- Carol / `@willingc`
- Ned / `@nedbat`
- CAM / `@CAM-Gerlach`
- Bradley
- Ashley / `@AWhetter`

## Reports and celebrations

- [Carol] Docs summit at PyCon US 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/

## Discussion

### Changelog splitting/reduction

No use cases other than "grepping it all" found so far.

### [CAM] WarningMessage is undocumented

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

## Next meeting

The docs team generally meets on the first Tuesday of every month around 19:00-ish UTC.

We have a recurring Google Calendar event for the meeting.
Let Mariatta know your email address and she can invite you.
1 change: 1 addition & 0 deletions docs/monthly-meeting/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -37,3 +37,4 @@ Monthly reports in chronological order.
Jan 2024 <2024-01.md>
Feb 2024 <2024-02.md>
Mar 2024 <2024-03.md>
Apr 2024 <2024-04.md>

0 comments on commit a7a48bf

Please sign in to comment.