|
| 1 | +# Documentation Community Team Meeting (July 2023) |
| 2 | + |
| 3 | +- **Date:** 2023-07-03 |
| 4 | +- **Time:** [19:00 UTC](https://arewemeetingyet.com/UTC/2023-07-03/19:00/Docs%20Meeting) |
| 5 | +- **This HackMD:** [https://hackmd.io/@encukou/pydocswg1](https://hackmd.io/@encukou/pydocswg1) |
| 6 | +- [**Discourse thread**](https://discuss.python.org/t/28736) (for July) |
| 7 | +- [**Meeting reports**](https://docs-community.readthedocs.io/en/latest/monthly-meeting/index.html) (the latest one might be an [**unmerged PR**](https://github.com/python/docs-community/pulls)) |
| 8 | +- **Calendar event:** (send your e-mail to Mariatta for an invitation) |
| 9 | +- **How to participate:** |
| 10 | + - Go to [Google Meet](https://meet.google.com/dii-qrzf-wkw) and ask to be let in. |
| 11 | + - 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). |
| 12 | + |
| 13 | +By participating in this meeting, you are agreeing to abide by and uphold the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/). |
| 14 | +Please take a second to read through it! |
| 15 | + |
| 16 | + |
| 17 | +## Roll call |
| 18 | + |
| 19 | +(Name / `@GitHubUsername` / Discord if different) |
| 20 | +- Petr Viktorin / `@encukou` |
| 21 | +- Ege Akman / `@egeakman` |
| 22 | +- Hugo van Kemenade / `@hugovk` |
| 23 | +- Marcus Sherman / `@betteridiot` |
| 24 | +- CAM / `@CAM-Gerlach` |
| 25 | +- Ned / `@nedbat` |
| 26 | +- Manuel / `@humitos` |
| 27 | + |
| 28 | + |
| 29 | +## Discussion |
| 30 | + |
| 31 | +* Thoughts on MDN icons (see e.g. the ToC sidebar for [Document](https://developer.mozilla.org/en-US/docs/Web/API/Document)), as a compact way to flag API status in overviews? |
| 32 | + * 🗑️ = deprecated |
| 33 | + * ⚠️ = non-standard/implementation-specific |
| 34 | + * 🧪 = experimental/unstable |
| 35 | + |
| 36 | +* Programmatic handling of `deprecated-removed` |
| 37 | + * Followup from [soft deprecation discussion](https://discuss.python.org/t/formalize-the-concept-of-soft-deprecation-dont-schedule-removal-in-pep-387-backwards-compatibility-policy/27957/73) |
| 38 | + * MVP should be up by next meeting: |
| 39 | + * A list of everything that's deprecated |
| 40 | + * docs on the directive in the devguide |
| 41 | + |
| 42 | +* Thoughts on putting a translation progress notice in docs pages (for each language)? [python/docsbuild-scripts#148](https://github.com/python/docsbuild-scripts/issues/148) |
| 43 | + * Sounds like a good idea |
| 44 | + * Sphinx issue is open |
| 45 | + * This should be done in Sphinx first - Manuel will look into it ([sphinx-doc/sphinx#11157](https://github.com/sphinx-doc/sphinx/issues/11157)) |
| 46 | + * Spanish docs have a [neat progress page](https://python-docs-es.readthedocs.io/es/3.11/progress.html) |
| 47 | + * Should we add it to all translations? |
| 48 | + |
| 49 | + |
| 50 | +## Next meeting |
| 51 | + |
| 52 | +The docs team generally meets on the first Monday of every month. |
| 53 | + |
| 54 | +We have a recurring Google Calendar event for the meeting. |
| 55 | +Let Mariatta know your email address and she can invite you. |
0 commit comments