Documentation Community Team Meeting (July 2023)¶
Date: 2023-07-03
Time: 19:00 UTC
This HackMD: https://hackmd.io/@encukou/pydocswg1
Discourse thread (for July)
Meeting reports (the latest one might be an unmerged PR)
Calendar event: (send your e-mail to Mariatta for an invitation)
How to participate:
Go to Google Meet and ask to be let in.
To edit notes, click the “pencil” or “split view” button on the HackMD document. 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. Please take a second to read through it!
Roll call¶
(Name / @GitHubUsername
/ Discord if different)
Petr Viktorin /
@encukou
Ege Akman /
@egeakman
Hugo van Kemenade /
@hugovk
Marcus Sherman /
@betteridiot
CAM /
@CAM-Gerlach
Ned /
@nedbat
Manuel /
@humitos
Discussion¶
Thoughts on MDN icons (see e.g. the ToC sidebar for Document), as a compact way to flag API status in overviews?
🗑️ = deprecated
⚠️ = non-standard/implementation-specific
🧪 = experimental/unstable
Programmatic handling of
deprecated-removed
Followup from soft deprecation discussion
MVP should be up by next meeting:
A list of everything that’s deprecated
docs on the directive in the devguide
Thoughts on putting a translation progress notice in docs pages (for each language)? python/docsbuild-scripts#148
Sounds like a good idea
Sphinx issue is open
This should be done in Sphinx first - Manuel will look into it (sphinx-doc/sphinx#11157)
Spanish docs have a neat progress page
Should we add it to all translations?
Next meeting¶
The docs team generally meets on the first Monday of every month.
We have a recurring Google Calendar event for the meeting. Let Mariatta know your email address and she can invite you.