Documentation Community Team Meeting (July 2023)#

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


  • 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

    • 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.