fix(ci): install SDK dependencies before docs build (#14)

* 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.

* 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.

* fix(ci): correct sdk path for GitHub Actions workspace

* 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

* ci: re-trigger build after RFC-004/005 merged to main

Author: beonde

.github/workflows/deploy.yml

@@ -97,10 +97,13 @@ jobs:
 
       - name: Install dependencies
         run: |
+          # 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
           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: |

mkdocs.yml

@@ -79,19 +79,21 @@ 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
             show_signature_annotations: true
             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