From 75765e90ec87c626fc2229afd008f9e3ec2e78bf Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 15 Oct 2026 20:43:50 +0000 Subject: [PATCH] fix(docs): stop quick-reference boxes overlapping and double-numbering DocsQuickReference renders its label as an h3 inside .docs-prose, whose h3 rule (margin-bottom: -16px) pulled the label over the first step. Render the label as a div so prose heading styles don't apply. The component already numbers each item (01, 02, ...), but 147 items in 48 docs pages also carried a hand-written "01 " prefix, so steps showed as "01 01 ...". Strip the duplicate prefixes from the content; every prefix matched its position, so the displayed numbers are unchanged. Co-Authored-By: Claude Opus 5.5 (1M context) Signed-off-by: Claude --- src/components/docs/DocsQuickReference.astro | 4 ++-- src/content/docs/agent-game-protocols.mdx | 6 +++--- src/content/docs/air-gapped-installation.mdx | 8 ++++---- src/content/docs/api-realtime-development.mdx | 6 +++--- src/content/docs/audit-observability-admin.mdx | 6 +++--- src/content/docs/backup-destinations.mdx | 6 +++--- src/content/docs/backup-repository-operations.mdx | 6 +++--- src/content/docs/backups-recovery.mdx | 6 +++--- src/content/docs/ci-releases-signing.mdx | 6 +++--- src/content/docs/cluster-nodes-kubeconfig.mdx | 6 +++--- src/content/docs/cluster-storage.mdx | 6 +++--- src/content/docs/console-events-logs.mdx | 6 +++--- src/content/docs/contribution-design-workflow.mdx | 8 ++++---- src/content/docs/create-a-server.mdx | 6 +++--- src/content/docs/credential-rotation.mdx | 6 +++--- src/content/docs/dashboard-tour.mdx | 6 +++--- src/content/docs/database-configuration.mdx | 6 +++--- src/content/docs/database-migrations.mdx | 6 +++--- src/content/docs/extension-services.mdx | 6 +++--- src/content/docs/file-manager.mdx | 6 +++--- src/content/docs/gametemplate-schema.mdx | 6 +++--- src/content/docs/general-server-settings.mdx | 6 +++--- src/content/docs/high-availability.mdx | 6 +++--- src/content/docs/ingress-tls-access.mdx | 6 +++--- src/content/docs/lifecycle-probes.mdx | 6 +++--- src/content/docs/local-development-setup.mdx | 6 +++--- src/content/docs/mod-registry-credentials.mdx | 6 +++--- src/content/docs/mods-modpacks.mdx | 6 +++--- src/content/docs/modules-sources.mdx | 6 +++--- src/content/docs/multi-cluster.mdx | 6 +++--- src/content/docs/network-automation.mdx | 6 +++--- src/content/docs/operator-crd-development.mdx | 6 +++--- src/content/docs/ownership-danger-zone.mdx | 6 +++--- src/content/docs/public-website-development.mdx | 6 +++--- src/content/docs/remote-agent-gateway.mdx | 8 ++++---- src/content/docs/server-configuration.mdx | 6 +++--- src/content/docs/server-operations.mdx | 6 +++--- src/content/docs/server-overview.mdx | 6 +++--- src/content/docs/sign-in-recovery.mdx | 6 +++--- src/content/docs/system-log-viewer.mdx | 6 +++--- src/content/docs/template-configuration.mdx | 6 +++--- src/content/docs/test-publish-sign-modules.mdx | 6 +++--- src/content/docs/troubleshooting.mdx | 6 +++--- src/content/docs/uninstall-decommission.mdx | 6 +++--- src/content/docs/upgrades-migrations.mdx | 6 +++--- src/content/docs/upload-a-module.mdx | 6 +++--- src/content/docs/user-administration.mdx | 6 +++--- src/content/docs/users-auth-rbac.mdx | 6 +++--- src/content/docs/web-dashboard-development.mdx | 6 +++--- 49 files changed, 149 insertions(+), 149 deletions(-) diff --git a/src/components/docs/DocsQuickReference.astro b/src/components/docs/DocsQuickReference.astro index ac74e8c..989e220 100644 --- a/src/components/docs/DocsQuickReference.astro +++ b/src/components/docs/DocsQuickReference.astro @@ -8,9 +8,9 @@ const { label, items } = Astro.props; ---
-

+
{label} -

+
{items.map((item, idx) => (
{String(idx + 1).padStart(2, "0")}   {item}
diff --git a/src/content/docs/agent-game-protocols.mdx b/src/content/docs/agent-game-protocols.mdx index 38ec82c..82e13a3 100644 --- a/src/content/docs/agent-game-protocols.mdx +++ b/src/content/docs/agent-game-protocols.mdx @@ -122,9 +122,9 @@ Module capabilities are the contract between the operator and the agent. To add diff --git a/src/content/docs/air-gapped-installation.mdx b/src/content/docs/air-gapped-installation.mdx index 4d031b0..d5a4352 100644 --- a/src/content/docs/air-gapped-installation.mdx +++ b/src/content/docs/air-gapped-installation.mdx @@ -350,9 +350,9 @@ If possible, disconnect the cluster from the public internet (or block all egres diff --git a/src/content/docs/api-realtime-development.mdx b/src/content/docs/api-realtime-development.mdx index 2fba442..b79a495 100644 --- a/src/content/docs/api-realtime-development.mdx +++ b/src/content/docs/api-realtime-development.mdx @@ -259,9 +259,9 @@ Run the test via `make test-integration`. diff --git a/src/content/docs/audit-observability-admin.mdx b/src/content/docs/audit-observability-admin.mdx index f74bc4a..2aed073 100644 --- a/src/content/docs/audit-observability-admin.mdx +++ b/src/content/docs/audit-observability-admin.mdx @@ -57,9 +57,9 @@ Each sink is tested independently via the Dashboard form before saving. The API diff --git a/src/content/docs/backup-destinations.mdx b/src/content/docs/backup-destinations.mdx index 56d7028..c4286ef 100644 --- a/src/content/docs/backup-destinations.mdx +++ b/src/content/docs/backup-destinations.mdx @@ -190,9 +190,9 @@ kubectl get backupschedules -A -o jsonpath='{range .items[*]}{.metadata.name}{"\ diff --git a/src/content/docs/backup-repository-operations.mdx b/src/content/docs/backup-repository-operations.mdx index fffd2b2..11f8270 100644 --- a/src/content/docs/backup-repository-operations.mdx +++ b/src/content/docs/backup-repository-operations.mdx @@ -169,9 +169,9 @@ This separation ensures that a compromised workload credential does not also com diff --git a/src/content/docs/backups-recovery.mdx b/src/content/docs/backups-recovery.mdx index d4972e2..8d8bb9f 100644 --- a/src/content/docs/backups-recovery.mdx +++ b/src/content/docs/backups-recovery.mdx @@ -111,9 +111,9 @@ Restore into a new server for verification, or overwrite only after stopping wri diff --git a/src/content/docs/ci-releases-signing.mdx b/src/content/docs/ci-releases-signing.mdx index 69801cc..33926e8 100644 --- a/src/content/docs/ci-releases-signing.mdx +++ b/src/content/docs/ci-releases-signing.mdx @@ -73,9 +73,9 @@ A `v` tag builds and signs images, packages the OCI chart, creates release notes @", + "go build ./... && npx tsc --noEmit # Lightweight local compile checks", + "git tag vX.Y.Z && git push origin vX.Y.Z", + "cosign verify --key cosign.pub ghcr.io/gameplanepanel/gameplane/@", ]} /> diff --git a/src/content/docs/cluster-nodes-kubeconfig.mdx b/src/content/docs/cluster-nodes-kubeconfig.mdx index c0bc918..2102445 100644 --- a/src/content/docs/cluster-nodes-kubeconfig.mdx +++ b/src/content/docs/cluster-nodes-kubeconfig.mdx @@ -151,9 +151,9 @@ Mint a short-lived token for the intended cluster, run the generated join proced diff --git a/src/content/docs/cluster-storage.mdx b/src/content/docs/cluster-storage.mdx index 8900e58..85ec7e3 100644 --- a/src/content/docs/cluster-storage.mdx +++ b/src/content/docs/cluster-storage.mdx @@ -75,9 +75,9 @@ Start with Kubernetes' built-in scheduler — it balances pods across nodes, res diff --git a/src/content/docs/console-events-logs.mdx b/src/content/docs/console-events-logs.mdx index 3f65d50..e3b61e4 100644 --- a/src/content/docs/console-events-logs.mdx +++ b/src/content/docs/console-events-logs.mdx @@ -98,9 +98,9 @@ The game's primary log file is configured in the template's `spec.logPath` (e.g. diff --git a/src/content/docs/contribution-design-workflow.mdx b/src/content/docs/contribution-design-workflow.mdx index 0ad7471..06cb9d2 100644 --- a/src/content/docs/contribution-design-workflow.mdx +++ b/src/content/docs/contribution-design-workflow.mdx @@ -78,10 +78,10 @@ Compile and commit focused changes with sign-off; CI verifies the full test, lin diff --git a/src/content/docs/create-a-server.mdx b/src/content/docs/create-a-server.mdx index 68752ac..94305d3 100644 --- a/src/content/docs/create-a-server.mdx +++ b/src/content/docs/create-a-server.mdx @@ -52,8 +52,8 @@ Pick a service model, validate every port, then watch the GameServer reconcile t diff --git a/src/content/docs/credential-rotation.mdx b/src/content/docs/credential-rotation.mdx index ac121ac..79b76f2 100644 --- a/src/content/docs/credential-rotation.mdx +++ b/src/content/docs/credential-rotation.mdx @@ -121,8 +121,8 @@ Revoke compromised material, invalidate sessions, preserve evidence, and test th diff --git a/src/content/docs/dashboard-tour.mdx b/src/content/docs/dashboard-tour.mdx index 31b5be5..e29e75c 100644 --- a/src/content/docs/dashboard-tour.mdx +++ b/src/content/docs/dashboard-tour.mdx @@ -75,8 +75,8 @@ A healthy workflow moves from intent to reconciliation, then closes the loop wit diff --git a/src/content/docs/database-configuration.mdx b/src/content/docs/database-configuration.mdx index 9d34654..b241e9a 100644 --- a/src/content/docs/database-configuration.mdx +++ b/src/content/docs/database-configuration.mdx @@ -245,8 +245,8 @@ After restoring the database, verify: diff --git a/src/content/docs/database-migrations.mdx b/src/content/docs/database-migrations.mdx index f82c541..5ccf539 100644 --- a/src/content/docs/database-migrations.mdx +++ b/src/content/docs/database-migrations.mdx @@ -181,9 +181,9 @@ Before committing a migration file: .sql", - "02 cd api && go test ./internal/db", - "03 cd api && go test -tags postgres ./internal/db", + "api/internal/db/migrations/012_.sql", + "cd api && go test ./internal/db", + "cd api && go test -tags postgres ./internal/db", ]} /> diff --git a/src/content/docs/extension-services.mdx b/src/content/docs/extension-services.mdx index 01ef8a3..11bd7c6 100644 --- a/src/content/docs/extension-services.mdx +++ b/src/content/docs/extension-services.mdx @@ -135,9 +135,9 @@ Maintain an independent module, tests, image, chart opt-in, health/metrics, boun diff --git a/src/content/docs/file-manager.mdx b/src/content/docs/file-manager.mdx index 1df4178..3474676 100644 --- a/src/content/docs/file-manager.mdx +++ b/src/content/docs/file-manager.mdx @@ -98,9 +98,9 @@ Apply one concern, restart only when required, and validate Events and game logs diff --git a/src/content/docs/gametemplate-schema.mdx b/src/content/docs/gametemplate-schema.mdx index bbfb352..d9d3e4b 100644 --- a/src/content/docs/gametemplate-schema.mdx +++ b/src/content/docs/gametemplate-schema.mdx @@ -165,9 +165,9 @@ Key sub-specs: diff --git a/src/content/docs/general-server-settings.mdx b/src/content/docs/general-server-settings.mdx index b5e69f6..33e09bb 100644 --- a/src/content/docs/general-server-settings.mdx +++ b/src/content/docs/general-server-settings.mdx @@ -75,8 +75,8 @@ When you leave the image field blank, the server inherits the image selected by diff --git a/src/content/docs/high-availability.mdx b/src/content/docs/high-availability.mdx index aa9505b..841b5f9 100644 --- a/src/content/docs/high-availability.mdx +++ b/src/content/docs/high-availability.mdx @@ -96,9 +96,9 @@ Drain or terminate one dependency at a time and measure: diff --git a/src/content/docs/ingress-tls-access.mdx b/src/content/docs/ingress-tls-access.mdx index 9e8eb3a..a53c77c 100644 --- a/src/content/docs/ingress-tls-access.mdx +++ b/src/content/docs/ingress-tls-access.mdx @@ -211,8 +211,8 @@ The `$SESSION_TOKEN` comes from a prior dashboard login, not a Kubernetes token. diff --git a/src/content/docs/lifecycle-probes.mdx b/src/content/docs/lifecycle-probes.mdx index ba30d9a..95b6967 100644 --- a/src/content/docs/lifecycle-probes.mdx +++ b/src/content/docs/lifecycle-probes.mdx @@ -98,9 +98,9 @@ Override timing one probe family at a time; startup protects boot, readiness gat diff --git a/src/content/docs/local-development-setup.mdx b/src/content/docs/local-development-setup.mdx index c3f31ea..78f2c42 100644 --- a/src/content/docs/local-development-setup.mdx +++ b/src/content/docs/local-development-setup.mdx @@ -74,8 +74,8 @@ Keep host and cluster registry addresses, kube context, namespaces, image tags, diff --git a/src/content/docs/mod-registry-credentials.mdx b/src/content/docs/mod-registry-credentials.mdx index f832b53..b05e56f 100644 --- a/src/content/docs/mod-registry-credentials.mdx +++ b/src/content/docs/mod-registry-credentials.mdx @@ -90,9 +90,9 @@ Run a compatible harmless search, diagnose without exposing the key, then rotate diff --git a/src/content/docs/mods-modpacks.mdx b/src/content/docs/mods-modpacks.mdx index 6e56594..8cea41e 100644 --- a/src/content/docs/mods-modpacks.mdx +++ b/src/content/docs/mods-modpacks.mdx @@ -74,8 +74,8 @@ Back up first, confirm the manifest, allow the required restart, and validate ev diff --git a/src/content/docs/modules-sources.mdx b/src/content/docs/modules-sources.mdx index b5f8772..c8093a8 100644 --- a/src/content/docs/modules-sources.mdx +++ b/src/content/docs/modules-sources.mdx @@ -93,9 +93,9 @@ Package metadata, templates, assets, and compatibility as versioned OCI content diff --git a/src/content/docs/multi-cluster.mdx b/src/content/docs/multi-cluster.mdx index fce36c5..4c4c345 100644 --- a/src/content/docs/multi-cluster.mdx +++ b/src/content/docs/multi-cluster.mdx @@ -132,9 +132,9 @@ Promote `Cluster` CRs, `GameTemplate`, and `Module` manifests through version co diff --git a/src/content/docs/network-automation.mdx b/src/content/docs/network-automation.mdx index f055a0e..dab24a1 100644 --- a/src/content/docs/network-automation.mdx +++ b/src/content/docs/network-automation.mdx @@ -107,9 +107,9 @@ A **BackupSchedule** CRD runs backups on a recurring cron schedule. Each schedul diff --git a/src/content/docs/operator-crd-development.mdx b/src/content/docs/operator-crd-development.mdx index abcb14d..6e9ff05 100644 --- a/src/content/docs/operator-crd-development.mdx +++ b/src/content/docs/operator-crd-development.mdx @@ -83,9 +83,9 @@ Use unit tests for helpers, envtest for API/controller behavior, and Kind E2E fo diff --git a/src/content/docs/ownership-danger-zone.mdx b/src/content/docs/ownership-danger-zone.mdx index 331f3a3..b22b0ac 100644 --- a/src/content/docs/ownership-danger-zone.mdx +++ b/src/content/docs/ownership-danger-zone.mdx @@ -68,9 +68,9 @@ Both operations require a verified backup and an explicit owner decision: diff --git a/src/content/docs/public-website-development.mdx b/src/content/docs/public-website-development.mdx index 6b0a52f..d1efd86 100644 --- a/src/content/docs/public-website-development.mdx +++ b/src/content/docs/public-website-development.mdx @@ -74,8 +74,8 @@ Update Pencil first for visual changes, edit MDX and navigation together, merge diff --git a/src/content/docs/remote-agent-gateway.mdx b/src/content/docs/remote-agent-gateway.mdx index 27fb500..d3ffd49 100644 --- a/src/content/docs/remote-agent-gateway.mdx +++ b/src/content/docs/remote-agent-gateway.mdx @@ -298,10 +298,10 @@ Record-only deletion does not free retained file storage. diff --git a/src/content/docs/server-configuration.mdx b/src/content/docs/server-configuration.mdx index e43e8e8..3a3a812 100644 --- a/src/content/docs/server-configuration.mdx +++ b/src/content/docs/server-configuration.mdx @@ -211,9 +211,9 @@ Before a user or operator deletes a server, ensure a recent backup exists. Enabl diff --git a/src/content/docs/server-operations.mdx b/src/content/docs/server-operations.mdx index 62d100d..1ff4acc 100644 --- a/src/content/docs/server-operations.mdx +++ b/src/content/docs/server-operations.mdx @@ -126,9 +126,9 @@ Treat transfers and destructive actions as audited workflows with a recovery pat diff --git a/src/content/docs/server-overview.mdx b/src/content/docs/server-overview.mdx index 519e27c..29a50a2 100644 --- a/src/content/docs/server-overview.mdx +++ b/src/content/docs/server-overview.mdx @@ -80,8 +80,8 @@ The quick-actions bar offers one-click access to common operations: diff --git a/src/content/docs/sign-in-recovery.mdx b/src/content/docs/sign-in-recovery.mdx index ee0f34d..5f6e4fc 100644 --- a/src/content/docs/sign-in-recovery.mdx +++ b/src/content/docs/sign-in-recovery.mdx @@ -123,8 +123,8 @@ The `bootstrap-admin` command must be run on any API pod that can reach the data diff --git a/src/content/docs/system-log-viewer.mdx b/src/content/docs/system-log-viewer.mdx index 4a6b4bb..2e8cf7f 100644 --- a/src/content/docs/system-log-viewer.mdx +++ b/src/content/docs/system-log-viewer.mdx @@ -74,8 +74,8 @@ Join API request/audit evidence to operator reconciliation, conditions, events, diff --git a/src/content/docs/template-configuration.mdx b/src/content/docs/template-configuration.mdx index b23ecb9..489326f 100644 --- a/src/content/docs/template-configuration.mdx +++ b/src/content/docs/template-configuration.mdx @@ -93,9 +93,9 @@ Never pass secrets via plain ConfigFields of type `string`. Always use the `pass diff --git a/src/content/docs/test-publish-sign-modules.mdx b/src/content/docs/test-publish-sign-modules.mdx index 9335885..69fd044 100644 --- a/src/content/docs/test-publish-sign-modules.mdx +++ b/src/content/docs/test-publish-sign-modules.mdx @@ -68,9 +68,9 @@ To get started, generate a key pair using `cosign generate-key-pair`, store the ", - "03 cosign verify --key cosign.pub --insecure-ignore-tlog=true ", + "make dev-up && make modules-push", + "cosign sign --key env://COSIGN_PRIVATE_KEY --tlog-upload=false ", + "cosign verify --key cosign.pub --insecure-ignore-tlog=true ", ]} /> diff --git a/src/content/docs/troubleshooting.mdx b/src/content/docs/troubleshooting.mdx index 8fd1142..40211f4 100644 --- a/src/content/docs/troubleshooting.mdx +++ b/src/content/docs/troubleshooting.mdx @@ -49,9 +49,9 @@ When local checks are exhausted, share a minimal reproducible case without secre diff --git a/src/content/docs/uninstall-decommission.mdx b/src/content/docs/uninstall-decommission.mdx index aec6d15..a58fa55 100644 --- a/src/content/docs/uninstall-decommission.mdx +++ b/src/content/docs/uninstall-decommission.mdx @@ -203,9 +203,9 @@ Check for orphaned resources and costs, revoke credentials, and archive restorat diff --git a/src/content/docs/upgrades-migrations.mdx b/src/content/docs/upgrades-migrations.mdx index cc6fd9f..fccd4ca 100644 --- a/src/content/docs/upgrades-migrations.mdx +++ b/src/content/docs/upgrades-migrations.mdx @@ -191,9 +191,9 @@ kubectl rollout status deploy/gameplane-api -n gameplane-system diff --git a/src/content/docs/upload-a-module.mdx b/src/content/docs/upload-a-module.mdx index 9e6893f..2c144a4 100644 --- a/src/content/docs/upload-a-module.mdx +++ b/src/content/docs/upload-a-module.mdx @@ -112,9 +112,9 @@ Never mutate a released module archive. Instead, version-bump and canary in para diff --git a/src/content/docs/user-administration.mdx b/src/content/docs/user-administration.mdx index b0fe2b6..0b1c365 100644 --- a/src/content/docs/user-administration.mdx +++ b/src/content/docs/user-administration.mdx @@ -82,9 +82,9 @@ Periodically review: diff --git a/src/content/docs/users-auth-rbac.mdx b/src/content/docs/users-auth-rbac.mdx index 999646b..e1e0d8c 100644 --- a/src/content/docs/users-auth-rbac.mdx +++ b/src/content/docs/users-auth-rbac.mdx @@ -125,9 +125,9 @@ After deployment, admins can override role mappings through the dashboard withou diff --git a/src/content/docs/web-dashboard-development.mdx b/src/content/docs/web-dashboard-development.mdx index 47a46f2..19729a9 100644 --- a/src/content/docs/web-dashboard-development.mdx +++ b/src/content/docs/web-dashboard-development.mdx @@ -73,9 +73,9 @@ Use strict build, lint, Vitest/MSW, and the appropriate Playwright mode; UI chan