Documentation Community Team Meeting (July 3, 2023)

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?