feat: documentation site

Docusaurus 3 docs-only site at docsite/, served statically by nginx under /docs on the marketing host. Covers getting started (self-hosted install through first server and first licence), the control plane, Vantage HQ, a reference section and operations. Wired into docker-compose.site.yml as docsite (3005:80) and into the image build workflow, rebuilding on its own directory only. Never added to the self-hosted compose file.
2026-07-28 15:46:33 +01:00
parent d9945882e5
commit f46fb7fc0e
46 changed files with 23697 additions and 2 deletions
@@ -0,0 +1,74 @@
+import type { SidebarsConfig } from "@docusaurus/plugin-content-docs";
+
+// Authored by hand rather than autogenerated, so ordering is a decision and
+// not a filename accident.
+const sidebars: SidebarsConfig = {
+    docs: [
+        "index",
+        {
+            type: "category",
+            label: "Getting started",
+            collapsed: false,
+            items: [
+                "getting-started/what-is-vantage",
+                "getting-started/cloud-vs-self-hosted",
+                "getting-started/self-hosted-install",
+                "getting-started/first-login",
+                "getting-started/first-server",
+                "getting-started/claim-free-licence",
+            ],
+        },
+        {
+            type: "category",
+            label: "Vantage",
+            items: [
+                "vantage/servers",
+                "vantage/ssh-keys",
+                "vantage/workflows",
+                "vantage/monitors",
+                "vantage/notification-channels",
+                "vantage/secrets",
+                "vantage/browser-console",
+                "vantage/audit-log",
+                "vantage/settings",
+            ],
+        },
+        {
+            type: "category",
+            label: "Vantage HQ",
+            items: [
+                "hq/accounts-and-signup",
+                "hq/people-and-roles",
+                "hq/cloud-instances",
+                "hq/self-hosted-instances",
+                "hq/licensing-and-entitlements",
+                "hq/billing",
+                "hq/free-tier",
+            ],
+        },
+        {
+            type: "category",
+            label: "Reference",
+            items: [
+                "reference/environment-variables",
+                "reference/rest-api",
+                "reference/grpc-api",
+                "reference/agent-config",
+                "reference/ports-and-networking",
+                "reference/troubleshooting",
+            ],
+        },
+        {
+            type: "category",
+            label: "Operations",
+            items: [
+                "operations/upgrading",
+                "operations/backups",
+                "operations/agent-updates",
+                "operations/ci-cd",
+            ],
+        },
+    ],
+};
+
+export default sidebars;