Skip to content

Commit

Permalink
Hugo's notes
Browse files Browse the repository at this point in the history
Co-authored-by: Hugo van Kemenade <[email protected]>
  • Loading branch information
AA-Turner and hugovk authored Jan 8, 2025
1 parent 358d065 commit 495aa61
Showing 1 changed file with 4 additions and 12 deletions.
16 changes: 4 additions & 12 deletions docs/monthly-meeting/2025-01.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
- [**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:**
- We are using Discord: https://discord.gg/RxKXyPYV?event=1303462925834522666
- We are using Discord: <https://discord.gg/RxKXyPYV?event=1303462925834522666>
- 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/).
Expand All @@ -19,7 +19,7 @@ Please take a second to read through it!
(Name / `@GitHubUsername` *[/ Discord, if different]*)

- Adam / `@AA-Turner`
- Hugo / `@hugovk`
- Hugo van Kemenade / `@hugovk`
- Petr Viktorin / `@encukou`
- Trey Hunner / `@treyhunner`
- Keith / `@KeithTheEE`
Expand Down Expand Up @@ -68,10 +68,10 @@ This was Sherry's first meeting, introductions were made.

- Petr and Blaise have been working on an improved version of Sphinx's `production-list` directive to represent and document Python's grammar.
- Petr provided a demonstration of his work.
- There is an initial PR to add the directives at [#127835](https://github.com/python/cpython/pull/127835)
- There is an initial PR to add the directives at [python/cpython#127835](https://github.com/python/cpython/pull/127835)
- This initially adds the directive, grammar snippets (and the surrounding prose) will be converted later, potentially looking to make this automatic.

### Docs for beginners
### Tutorial for beginners

- Can we break up the work so people can contribute in parallel?
- Is this better on `docs.python.org`, or third parties (O'Reilly, w3schools, etc.)?
Expand All @@ -84,14 +84,6 @@ This was Sherry's first meeting, introductions were made.
- Mariatta was driving the effort.


### Python Project Documentation

*Relating to `docs.python.org`, `peps.python.org`, `devguide.python.org`, etc.*

- [bswck] Track upstream->downstream translation block update alerts
- Not discussed.


## Next meeting

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

0 comments on commit 495aa61

Please sign in to comment.