docs(fonts[lint]): add docstrings to sphinx_fonts extension

why: ruff D101/D103 rules flag missing docstrings on SetupDict and setup(), causing CI lint failures in repos that lint docs/_ext/. what: - Add docstring to SetupDict TypedDict class - Add docstring to setup() function
vcs-python · tony · Mar 14, 2026 · Mar 14, 2026 · Mar 14, 2026 · Mar 14, 2026
commit f128bf277367918fe625ebf5c1f53d8e6e335410
diff --git a/docs/_ext/sphinx_fonts.py b/docs/_ext/sphinx_fonts.py
@@ -25,6 +25,8 @@
 
 
 class SetupDict(t.TypedDict):
+    """Return type for Sphinx extension setup()."""
+
     version: str
     parallel_read_safe: bool
     parallel_write_safe: bool
@@ -137,6 +139,7 @@ def _on_html_page_context(
 
 
 def setup(app: Sphinx) -> SetupDict:
+    """Register config values, events, and return extension metadata."""
     app.add_config_value("sphinx_fonts", [], "html")
     app.add_config_value("sphinx_font_fallbacks", [], "html")
     app.add_config_value("sphinx_font_css_variables", {}, "html")