Feat: migrate marketing site to Docusaurus (rossoctl) with synced docs

.github/ISSUE_TEMPLATE/3-bug-report.yml

@@ -38,10 +38,10 @@ body:
   - type: input
     id: version
     attributes:
-      label: Kagenti Version
+      label: Rossoctl Version
       description: |
-        If this bug is for the Kagenti platform, which version were you running? Check with:
-        helm list -n kagenti-system (app version column), or the git tag you checked out.
+        If this bug is for the Rossoctl platform, which version were you running? Check with:
+        helm list -n rossoctl-system (app version column), or the git tag you checked out.
       placeholder: "v0.6.0"
     validations:
       required: false

.github/ISSUE_TEMPLATE/4-epic.yml

@@ -38,7 +38,7 @@ body:
     attributes:
       label: Success criteria
       placeholder: |
-        - [ ] (Example) X is integrated with Kagenti
+        - [ ] (Example) X is integrated with Rossoctl
     validations:
       required: true
 

.github/pull_request_template.md

@@ -1,7 +1,7 @@
 <!--
 Thanks for creating a pull request!
 
-If this is your first time, please make sure to review [CONTRIBUTING.MD](https://github.com/kagenti/kagenti/blob/main/CONTRIBUTING.md).
+If this is your first time, please make sure to review [CONTRIBUTING.MD](https://github.com/rossoctl/rossoctl/blob/main/CONTRIBUTING.md).
 
 // Begin modifications with assistance from Copilot
 ╔══════════════════════════════════════════════════════════════╗

.github/workflows/add-to-project.yml

@@ -1,4 +1,4 @@
-name: Reusable - Add to Kagenti Project
+name: Reusable - Add to Rossoctl Project
 
 on:
   workflow_call:
@@ -8,9 +8,9 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - name: Add issue or PR to Kagenti Project
+      - name: Add issue or PR to Rossoctl Project
         continue-on-error: true
         uses: actions/add-to-project@2e5cc851ca7162e9eb510e6da6a5c64022e606a7 # v1.0.0
         with:
-          project-url: https://github.com/orgs/kagenti/projects/8
+          project-url: https://github.com/orgs/rossoctl/projects/8
           github-token: ${{ secrets.ADD_TO_PROJECT_PAT }}

.github/workflows/deploy.yaml

@@ -0,0 +1,69 @@
+name: Deploy site to Pages
+
+# Builds the Docusaurus site and deploys it to GitHub Pages.
+#
+# The Docs section is synced from rossoctl/rossoctl:docs/ at build time
+# (npm run sync-docs). Triggers:
+#   - push to main            (site source changed)
+#   - repository_dispatch     (docs changed upstream; sent by
+#                              rossoctl/rossoctl .github/workflows/docs-dispatch.yaml)
+#   - schedule                (daily fallback so docs never drift)
+#   - workflow_dispatch       (manual)
+on:
+  push:
+    branches: [main]
+  repository_dispatch:
+    types: [docs-updated]
+  schedule:
+    - cron: "17 6 * * *" # daily 06:17 UTC fallback resync
+  workflow_dispatch: {}
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+
+      - name: Setup Node
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Sync docs from rossoctl/rossoctl:docs
+        run: npm run sync-docs
+
+      - name: Build
+        run: npm run build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5.0.0
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3.0.1
+        with:
+          path: build
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4.0.5

.github/workflows/link_checker.yaml

@@ -22,5 +22,5 @@ jobs:
         uses: filiph/linkcheck@3.0.0
         with:
           arguments: |
-            https://kagenti.github.io/.github/ \
+            https://rossoctl.github.io/.github/ \
             --skip-file skip_file.txt -e --no-check-anchors

.github/workflows/pr-verifier-required.yml

@@ -7,7 +7,7 @@ on:
 jobs:
   pr-title-check:
     # Keep the host repo clean (skipped checks are marked success)
-    if: ${{ github.repository != 'kagenti/.github' }}
+    if: ${{ github.repository != 'rossoctl/.github' }}
     runs-on: ubuntu-latest
 
     env:
@@ -35,4 +35,4 @@ jobs:
           echo "::error::PR title must start with one of:"
           echo "::error::  Build, Chore, Ci, CI, Docs, Feat, Fix, Perf, Refactor, Revert, Style, Test"
           echo "::error::  Feature, Bug fix, Proposal, Breaking change, Other/Misc"
-          echo "::notice::See the org PR template for guidance: https://github.com/kagenti/.github/blob/main/.github/pull_request_template.md"
+          echo "::notice::See the org PR template for guidance: https://github.com/rossoctl/.github/blob/main/.github/pull_request_template.md"

.github/workflows/project.yml

@@ -1,4 +1,4 @@
-name: Kagenti Project Automation
+name: Rossoctl Project Automation
 
 on:
   issues:
@@ -11,14 +11,14 @@ permissions:
 
 jobs:
   add:
-    name: Add item to Kagenti Project
+    name: Add item to Rossoctl Project
 
     permissions:
       issues: write
       pull-requests: write
       contents: read
 
     # Pinned to @main intentionally: org-internal workflows propagate updates automatically.
-    uses: kagenti/.github/.github/workflows/add-to-project.yml@main
+    uses: rossoctl/.github/.github/workflows/add-to-project.yml@main
     secrets: inherit
 

.github/workflows/self-assign-reusable.yml

@@ -17,7 +17,7 @@
 #     issues: write
 #   jobs:
 #     self-assign:
-#       uses: kagenti/.github/.github/workflows/self-assign-reusable.yml@main
+#       uses: rossoctl/.github/.github/workflows/self-assign-reusable.yml@main
 #       secrets:
 #         ISSUE_ASSIGN_TOKEN: ${{ secrets.ISSUE_ASSIGN_TOKEN }}
 #
@@ -54,7 +54,7 @@ on:
 jobs:
   self_assign:
     name: Assign commenter to issue
-    if: ${{ github.repository != 'kagenti/.github' }}
+    if: ${{ github.repository != 'rossoctl/.github' }}
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -74,7 +74,7 @@ jobs:
 
   self_unassign:
     name: Unassign commenter from issue
-    if: ${{ github.repository != 'kagenti/.github' }}
+    if: ${{ github.repository != 'rossoctl/.github' }}
     runs-on: ubuntu-latest
     permissions:
       contents: read

.github/workflows/self-assign.yml

@@ -1,9 +1,9 @@
 # Issue Self-Assign
 #
 # Thin caller for the org-wide reusable self-assign workflow.
-# Configuration and defaults are managed centrally in kagenti/.github.
+# Configuration and defaults are managed centrally in rossoctl/.github.
 #
-# Reference: https://github.com/kagenti/.github/blob/main/.github/workflows/self-assign-reusable.yml
+# Reference: https://github.com/rossoctl/.github/blob/main/.github/workflows/self-assign-reusable.yml
 #
 name: Issue self-assign
 
@@ -17,6 +17,6 @@ permissions:
 
 jobs:
   self-assign:
-    uses: kagenti/.github/.github/workflows/self-assign-reusable.yml@main
+    uses: rossoctl/.github/.github/workflows/self-assign-reusable.yml@main
     secrets:
       ISSUE_ASSIGN_TOKEN: ${{ secrets.ISSUE_ASSIGN_TOKEN }}

.github/workflows/stale.yaml

@@ -17,11 +17,11 @@
 #     pull-requests: write
 #   jobs:
 #     stale:
-#       uses: kagenti/.github/.github/workflows/stale.yaml@main
+#       uses: rossoctl/.github/.github/workflows/stale.yaml@main
 #
 # All inputs have sensible defaults. Override only what you need:
 #
-#   uses: kagenti/.github/.github/workflows/stale.yaml@main
+#   uses: rossoctl/.github/.github/workflows/stale.yaml@main
 #   with:
 #     days-before-stale: 90
 #     exempt-issue-labels: 'high priority,bug,keep'
@@ -62,7 +62,7 @@ on:
 jobs:
   stale:
     name: Mark and Close Stale Items
-    if: ${{ github.repository != 'kagenti/.github' }}
+    if: ${{ github.repository != 'rossoctl/.github' }}
     runs-on: ubuntu-latest
     steps:
       - name: Process stale issues and PRs

.gitignore

@@ -1,4 +1,27 @@
+# --- Docusaurus site ---
+/node_modules
+/build
+/.docusaurus
+/.cache-loader
+
+# SYNCED from rossoctl/rossoctl at build time by scripts/sync-docs.sh — not
+# committed here, regenerated on every build:
+#   docs/           <- rossoctl/rossoctl:docs/  (Docs section)
+#   contributing/index.md <- rossoctl/rossoctl:CONTRIBUTING.md (Contributing page)
+/docs
+/contributing/index.md
+
+# --- Misc / editor ---
 .DS_Store
 .vscode/
 
-public/
+# Legacy Hugo output (kept from the previous static site)
+public/
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local

CLAUDE.md

@@ -1,4 +1,4 @@
-# CLAUDE.md - Kagenti .github Repository
+# CLAUDE.md - Rossoctl .github Repository
 
 ## DCO Sign-Off (Mandatory)