add docs group to uv dependencies for ci lint check

Author: sid-rl

.github/workflows/ci.yml

@@ -29,7 +29,7 @@ jobs:
           version: '0.10.2'
 
       - name: Install dependencies
-        run: uv sync --all-extras
+        run: uv sync --all-extras --group docs
 
       - name: Run lints
         run: ./scripts/lint

docs/conf.py

@@ -9,6 +9,7 @@
 import sys
 import pkgutil
 from typing import get_type_hints
+from typing_extensions import override
 
 from sphinx.errors import PycodeError
 from sphinx.pycode import ModuleAnalyzer
@@ -95,6 +96,7 @@ class _InheritedDocsTypedDictDocumenter(TypedDictDocumenter):
     Patching sphinx_toolbox 4.1.2.
     """
 
+    @override
     def sort_members(
         self,
         documenters: list[tuple[Documenter, bool]],
@@ -120,12 +122,12 @@ def sort_members(
         if required_keys:
             self.add_line("", sourcename)
             self.add_line(":Required Keys:", sourcename)
-            self.document_keys(required_keys, types, docstrings)
+            self.document_keys(required_keys, types, docstrings)  # pyright: ignore[reportUnknownMemberType]
             self.add_line("", sourcename)
         if optional_keys:
             self.add_line("", sourcename)
             self.add_line(":Optional Keys:", sourcename)
-            self.document_keys(optional_keys, types, docstrings)
+            self.document_keys(optional_keys, types, docstrings)  # pyright: ignore[reportUnknownMemberType]
             self.add_line("", sourcename)
 
         return []
@@ -160,7 +162,7 @@ def _inject_type_submodules(_app: Sphinx, docname: str, source: list[str]) -> No
 
 def setup(app: Sphinx) -> None:
     app.add_autodocumenter(_InheritedDocsTypedDictDocumenter, override=True)
-    app.connect("source-read", _inject_type_submodules)
+    app.connect("source-read", _inject_type_submodules)  # pyright: ignore[reportUnknownMemberType]
 
 
 # Intersphinx mapping

pyproject.toml

@@ -72,6 +72,7 @@ docs = [
     "furo>=2025.9.25",
     "sphinx>=7.4.7",
     "sphinx-autodoc-typehints>=2.3.0",
+    "sphinx-tabs>=3.4.0",
     "sphinx-toolbox>=4.0.0",
 ]
 
@@ -138,7 +139,6 @@ exclude = [
     "_dev",
     ".venv",
     ".git",
-    "docs",
 ]
 
 reportImplicitOverride = true
@@ -198,12 +198,6 @@ module = "black.files.*"
 ignore_errors = true
 ignore_missing_imports = true
 
-# Sphinx packages are only installed in the docs dependency group,
-# not in the dev group used by CI linters.
-[[tool.mypy.overrides]]
-module = ["sphinx.*", "sphinx_toolbox.*"]
-ignore_missing_imports = true
-
 
 [tool.ruff]
 line-length = 120