chore: use Sphinx for api doc generation

.gitignore

@@ -68,8 +68,12 @@ instance/
 # Scrapy stuff:
 .scrapy
 
+# Generated API docs
+api-docs/
+
 # Sphinx documentation
 **/docs/_build/
+docs/sphinx/_autogen/
 **/docs/source/_reference
 **/docs/source/_api_doc
 

Makefile

@@ -1,6 +1,24 @@
+.PHONY: install docs lint license-check test test-integration test-pkg test-pkg-integration
+
 install:
 	uv sync --all-packages --all-extras
 
+docs:
+	uv run sphinx-apidoc -e -M -f -T \
+		-o docs/sphinx/_autogen \
+		packages/base/ai_api_client_sdk \
+		packages/base/ai_api_client_sdk/helpers
+	uv run sphinx-apidoc -e -M -f -T \
+		-o docs/sphinx/_autogen \
+		packages/core/ai_core_sdk \
+		packages/core/ai_core_sdk/helpers \
+		packages/core/ai_core_sdk/cli.py
+	uv run sphinx-apidoc -e -M -f -T \
+		-o docs/sphinx/_autogen \
+		packages/gen/gen_ai_hub \
+		packages/gen/gen_ai_hub/evaluations/_internal
+	uv run sphinx-build -b html docs/sphinx api-docs/
+
 lint:
 	uv run pylint ai_api_client_sdk ai_core_sdk gen_ai_hub --errors-only --output-format=colorized
 

docs/sphinx/conf.py

@@ -0,0 +1,15 @@
+project = "SAP AI SDK Python"
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.napoleon",
+]
+html_theme = "furo"
+exclude_patterns = ["_autogen/modules.rst"]
+autodoc_default_options = {
+    "members": True,
+    "undoc-members": True,
+    "private-members": False,
+    "show-inheritance": True,
+    "special-members": "__init__",
+}
+autodoc_member_order = "bysource"

docs/sphinx/index.rst

@@ -0,0 +1,17 @@
+SAP AI SDK Python
+=================
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Packages
+
+   _autogen/ai_api_client_sdk
+   _autogen/ai_core_sdk
+   _autogen/gen_ai_hub
+
+Indices
+-------
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`

pyproject.toml

@@ -5,7 +5,7 @@ requires-python = ">=3.10"
 license = "Apache-2.0"
 
 [dependency-groups]
-dev = ["pip-licenses>=5.5.5", "commitizen>=4"]
+dev = ["pip-licenses>=5.5.5", "commitizen>=4", "sphinx>=7.0.0", "furo"]
 
 [tool.uv.sources]
 sap-ai-sdk-base = { workspace = true }