docs: replace Sphinx with MkDocs + mkdocstrings

- Replace sphinx/furo/sphinx-autoapi with mkdocs, mkdocs-material, and
  mkdocstrings in the docs dependency group
- Add mkdocs.yml with Material theme and mkdocstrings plugin
- Add docs/index.md landing page and api/ reference pages
- Remove all Sphinx .rst files (conf.py, index.rst, Makefile, hundreds
  of manual asset stubs)
- Update GitHub Actions workflow to use mkdocs build + deploy site/

Build time is now ~4s vs minutes with sphinx-autoapi.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: Aryamanz29

.github/workflows/pyatlan-docs.yaml

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: Apache-2.0
 # Copyright 2023 Atlan Pte. Ltd.
-name: Pyatlan Sphinx Docs Build
+name: Pyatlan MkDocs Build
 
 on:
   push:
@@ -10,7 +10,7 @@ on:
 jobs:
   publish-docs:
     runs-on: ubuntu-latest
-    name: "Sphinx"
+    name: "MkDocs"
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -26,11 +26,11 @@ jobs:
       - name: Install dependencies
         run: uv sync --group docs
 
-      - name: Build Sphinx docs
-        run: uv run sphinx-build -b html docs docs/_build
+      - name: Build MkDocs
+        run: uv run mkdocs build
 
       - name: Publish to GitHub Pages
         uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: docs/_build
+          publish_dir: site

docs/Makefile

@@ -0,0 +1,3 @@
+# Cache
+
+::: pyatlan.cache

docs/api/cache.md

@@ -0,0 +1,41 @@
+# Client
+
+## AtlanClient
+
+::: pyatlan.client.atlan.AtlanClient
+
+## Asset Client
+
+::: pyatlan.client.asset.AssetClient
+
+## Audit Client
+
+::: pyatlan.client.audit.AuditClient
+
+## File Client
+
+::: pyatlan.client.file.FileClient
+
+## Group Client
+
+::: pyatlan.client.group.GroupClient
+
+## Role Client
+
+::: pyatlan.client.role.RoleClient
+
+## Token Client
+
+::: pyatlan.client.token.TokenClient
+
+## User Client
+
+::: pyatlan.client.user.UserClient
+
+## Typedef Client
+
+::: pyatlan.client.typedef.TypeDefClient
+
+## Workflow Client
+
+::: pyatlan.client.workflow.WorkflowClient

docs/api/client.md

@@ -0,0 +1,3 @@
+# Errors
+
+::: pyatlan.errors

docs/api/errors.md

@@ -0,0 +1,3 @@
+# Events
+
+::: pyatlan.events

docs/api/events.md

@@ -0,0 +1,13 @@
+# Models
+
+## Search
+
+::: pyatlan.model.search
+
+## Typedef
+
+::: pyatlan.model.typedef
+
+## Packages
+
+::: pyatlan.model.packages

docs/api/model.md

@@ -0,0 +1,3 @@
+# Utils
+
+::: pyatlan.utils