From 1ba80a44572792db8b4546d17e966e7bbe0649f5 Mon Sep 17 00:00:00 2001 From: Beon de Nood Date: Sat, 10 Jan 2026 04:01:27 -0500 Subject: [PATCH 1/5] fix(docs): replace broken enterprise link with sales contact The '../../../enterprise/' relative link pointed to a non-existent folder. Replaced with mailto:sales@capisc.io as a contact point for enterprise deployment documentation. Discovered during documentation audit. --- docs/reference/server/deployment.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/server/deployment.md b/docs/reference/server/deployment.md index 8fb68a0..d8f75ce 100644 --- a/docs/reference/server/deployment.md +++ b/docs/reference/server/deployment.md @@ -329,4 +329,4 @@ error: signature verification failed - [API Reference](api.md) — Full API documentation - [Badge CA](badge-ca.md) — CA operations -- [Enterprise Deployment](../../../enterprise/) — Air-gapped and on-prem guides +- [Contact Sales](mailto:sales@capisc.io) — Enterprise deployment options (air-gapped, on-prem) From 1fea6074dfb5fec56ad1737c6ec2d434f0ef6cff Mon Sep 17 00:00:00 2001 From: Beon de Nood Date: Sat, 10 Jan 2026 14:21:52 -0500 Subject: [PATCH 2/5] fix(ci): install sdk dependencies before docs build mkdocstrings/griffe needs pydantic and other sdk dependencies installed to resolve base classes during documentation generation. Install capiscio-sdk-python (with its deps) before requirements-docs.txt. --- .github/workflows/deploy.yml | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml index aa9f6f3..47bbbdc 100644 --- a/.github/workflows/deploy.yml +++ b/.github/workflows/deploy.yml @@ -97,10 +97,13 @@ jobs: - name: Install dependencies run: | + # Install capiscio-sdk-python dependencies first (pydantic, etc.) + # This allows mkdocstrings/griffe to resolve base classes + pip install -e ../capiscio-sdk-python + + # Now install docs requirements cd capiscio-docs pip install -r requirements-docs.txt - # Install capiscio-sdk-python in editable mode for mkdocstrings to resolve types - pip install -e ../capiscio-sdk-python - name: Build documentation run: | From b2c23e540e28120b916d6e16fb0fb02c0b916775 Mon Sep 17 00:00:00 2001 From: Beon de Nood Date: Sat, 10 Jan 2026 14:23:14 -0500 Subject: [PATCH 3/5] fix(ci): correct sdk path for GitHub Actions workspace --- .github/workflows/deploy.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml index 47bbbdc..d0d0672 100644 --- a/.github/workflows/deploy.yml +++ b/.github/workflows/deploy.yml @@ -99,7 +99,7 @@ jobs: run: | # Install capiscio-sdk-python dependencies first (pydantic, etc.) # This allows mkdocstrings/griffe to resolve base classes - pip install -e ../capiscio-sdk-python + pip install -e capiscio-sdk-python # Now install docs requirements cd capiscio-docs From 8c59b8cfaddb7a767009f879950d6fe450ccab46 Mon Sep 17 00:00:00 2001 From: Beon de Nood Date: Sat, 10 Jan 2026 14:26:25 -0500 Subject: [PATCH 4/5] fix(ci): resolve griffe base class resolution errors - Install capiscio-sdk-python with [dev] extras to ensure all deps available - Move import/inventories to correct location in mkdocstrings config - Add preload_modules for pydantic to help griffe resolve base classes --- .github/workflows/deploy.yml | 6 +++--- mkdocs.yml | 12 +++++++----- 2 files changed, 10 insertions(+), 8 deletions(-) diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml index d0d0672..7edcc17 100644 --- a/.github/workflows/deploy.yml +++ b/.github/workflows/deploy.yml @@ -97,9 +97,9 @@ jobs: - name: Install dependencies run: | - # Install capiscio-sdk-python dependencies first (pydantic, etc.) - # This allows mkdocstrings/griffe to resolve base classes - pip install -e capiscio-sdk-python + # Install capiscio-sdk-python with all its dependencies (pydantic, etc.) + # The [dev] extra ensures all optional deps are available for mkdocstrings + pip install -e "capiscio-sdk-python[dev]" # Now install docs requirements cd capiscio-docs diff --git a/mkdocs.yml b/mkdocs.yml index 1fd6380..84a6186 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -79,6 +79,10 @@ plugins: handlers: python: paths: ["../capiscio-sdk-python"] + import: + # Enable cross-references to Python stdlib and pydantic + - https://docs.python.org/3/objects.inv + - https://docs.pydantic.dev/latest/objects.inv options: show_source: false show_root_heading: true @@ -86,12 +90,10 @@ plugins: separate_signature: true docstring_style: google members_order: source - # Allow unresolved references for external types (Exception, pydantic.BaseModel, etc.) show_if_no_docstring: false - inventories: - # Enable cross-references to Python stdlib and pydantic - - https://docs.python.org/3/objects.inv - - https://docs.pydantic.dev/latest/objects.inv + # Preload pydantic to resolve base classes + preload_modules: + - pydantic markdown_extensions: - admonition From fbac3652ddd3e971f5b0312aa8f16745a6b7a8c4 Mon Sep 17 00:00:00 2001 From: Beon de Nood Date: Sat, 10 Jan 2026 14:30:54 -0500 Subject: [PATCH 5/5] ci: re-trigger build after RFC-004/005 merged to main