Connector Framework documentation and CI workflow (#1)

* feat: add Connector Framework documentation and CI workflow

- Updated docs.json to include a new "Connector Framework" section with detailed pages on usage, configuration, and specifications.
- Introduced a GitHub Actions workflow for syncing Connector Framework documentation from the inorbit-connector-python repository.
- Modified connectors.mdx to link to the new Connector Framework documentation, enhancing accessibility for users.

* Fix broken links by adding placeholder pages

* Use a temporary branch

* Test trigger

* Sync connector framework docs from inorbit-connector-python

* Revert "Sync connector framework docs from inorbit-connector-python"

This reverts commit e14333d.

* Revert "Test trigger"

This reverts commit e6e8657.

* Revert "Use a temporary branch"

This reverts commit 1d04f04.

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: b-Tomas

.github/workflows/multirepo-connector-framework.yml

@@ -0,0 +1,60 @@
+name: Sync Connector Framework Docs
+
+on:
+  # Manual trigger
+  workflow_dispatch:
+  # Nightly sync
+  schedule:
+    - cron: "17 3 * * *"
+
+permissions:
+  contents: write
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout docs repo
+        uses: actions/checkout@v4
+        with:
+          path: docs-repo
+
+      - name: Checkout connector repo
+        uses: actions/checkout@v4
+        with:
+          repository: inorbit-ai/inorbit-connector-python
+          ref: main
+          path: connector-repo
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Build Mintlify-compatible docs
+        run: |
+          cd connector-repo/docs/mintlify
+          make build
+
+      - name: Sync to docs repo
+        run: |
+          # Remove old connector framework docs
+          rm -rf docs-repo/ground-control/robot-integration/connector-framework
+          
+          # Copy built docs
+          mkdir -p docs-repo/ground-control/robot-integration/connector-framework
+          cp -r connector-repo/docs/mintlify/_build/* docs-repo/ground-control/robot-integration/connector-framework/
+
+      - name: Commit and push
+        run: |
+          cd docs-repo
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          
+          git add -A
+          if git diff --staged --quiet; then
+            echo "No changes to commit"
+          else
+            git commit -m "Sync connector framework docs from inorbit-connector-python"
+            git push
+          fi

docs.json

@@ -78,6 +78,7 @@
               "ground-control/robot-integration/overview",
               "ground-control/robot-integration/agent",
               "ground-control/robot-integration/connectors",
+              "ground-control/robot-integration/connector-framework/index",
               "ground-control/robot-integration/robot-sdk",
               "ground-control/robot-integration/edge-sdk",
               "ground-control/robot-integration/interoperability"

ground-control/robot-integration/connector-framework/configuration.md

@@ -0,0 +1,7 @@
+---
+title: "Configuration"
+description: "Configuration models and file formats for connectors"
+---
+
+Content synced from [inorbit-connector-python](https://github.com/inorbit-ai/inorbit-connector-python).
+

ground-control/robot-integration/connector-framework/getting-started.md

@@ -0,0 +1,7 @@
+---
+title: "Getting Started"
+description: "Installation and setup for the InOrbit Connector Framework"
+---
+
+Content synced from [inorbit-connector-python](https://github.com/inorbit-ai/inorbit-connector-python).
+

ground-control/robot-integration/connector-framework/index.md

@@ -0,0 +1,9 @@
+---
+title: "Connector Framework"
+description: "Python framework for developing InOrbit robot connectors"
+---
+
+This page will be automatically populated by the [inorbit-connector-python](https://github.com/inorbit-ai/inorbit-connector-python) repository.
+
+See the [GitHub repository](https://github.com/inorbit-ai/inorbit-connector-python) for the latest documentation.
+

ground-control/robot-integration/connector-framework/publishing.md

@@ -0,0 +1,7 @@
+---
+title: "Publishing Data"
+description: "How to publish robot data to InOrbit"
+---
+
+Content synced from [inorbit-connector-python](https://github.com/inorbit-ai/inorbit-connector-python).
+

ground-control/robot-integration/connector-framework/specification/commands.md

@@ -0,0 +1,7 @@
+---
+title: "Commands Utilities"
+description: "Command handling utilities specification"
+---
+
+Content synced from [inorbit-connector-python](https://github.com/inorbit-ai/inorbit-connector-python).
+

ground-control/robot-integration/connector-framework/specification/connector.md

@@ -0,0 +1,7 @@
+---
+title: "Connector API"
+description: "Connector and FleetConnector class specifications"
+---
+
+Content synced from [inorbit-connector-python](https://github.com/inorbit-ai/inorbit-connector-python).
+

ground-control/robot-integration/connector-framework/specification/index.md

@@ -0,0 +1,7 @@
+---
+title: "Specification"
+description: "Public API specification for the inorbit-connector package"
+---
+
+Content synced from [inorbit-connector-python](https://github.com/inorbit-ai/inorbit-connector-python).
+

ground-control/robot-integration/connector-framework/specification/logging.md

@@ -0,0 +1,7 @@
+---
+title: "Logging"
+description: "Logging configuration specification"
+---
+
+Content synced from [inorbit-connector-python](https://github.com/inorbit-ai/inorbit-connector-python).
+