From 411211c21b3de89f91b25ecc40cb1aa42bded8f3 Mon Sep 17 00:00:00 2001 From: Vincent Koc Date: Tue, 5 May 2026 17:45:46 -0700 Subject: [PATCH] docs: drop in-body H1s and tighten heading hygiene across 4 pages docs/concepts/typebox.md: removed the duplicate '# TypeBox as protocol source of truth' H1 (Mintlify already renders the title from frontmatter; in-body H1s produce brittle anchors). Also removed the 'Last updated: 2026-01-10' timestamp line because date-stamped freshness markers drift silently and conflict with our brownfield maintenance model. docs/install/kubernetes.md: removed the duplicate '# OpenClaw on Kubernetes' H1. docs/install/azure.md: removed the duplicate '# OpenClaw on Azure Linux VM' H1. docs/install/podman.md: renamed the '## Podman + Tailscale' heading to '## Podman and Tailscale' per docs/CLAUDE.md heading-hygiene rules (plus signs collapse during Mintlify anchor generation just like ampersands and apostrophes). Kept the explicit anchor and updated the inline 'Podman + Tailscale' link text to match the new heading so the cross-link still works. --- docs/concepts/typebox.md | 4 ---- docs/install/azure.md | 2 -- docs/install/kubernetes.md | 2 -- docs/install/podman.md | 4 ++-- 4 files changed, 2 insertions(+), 10 deletions(-) diff --git a/docs/concepts/typebox.md b/docs/concepts/typebox.md index bab0d322870..fc79ea2d239 100644 --- a/docs/concepts/typebox.md +++ b/docs/concepts/typebox.md @@ -5,10 +5,6 @@ read_when: title: "TypeBox" --- -# TypeBox as protocol source of truth - -Last updated: 2026-01-10 - TypeBox is a TypeScript-first schema library. We use it to define the **Gateway WebSocket protocol** (handshake, request/response, server events). Those schemas drive **runtime validation**, **JSON Schema export**, and **Swift codegen** for diff --git a/docs/install/azure.md b/docs/install/azure.md index 23e783d48a2..1930ceb3bc4 100644 --- a/docs/install/azure.md +++ b/docs/install/azure.md @@ -7,8 +7,6 @@ read_when: title: "Azure" --- -# OpenClaw on Azure Linux VM - This guide sets up an Azure Linux VM with the Azure CLI, applies Network Security Group (NSG) hardening, configures Azure Bastion for SSH access, and installs OpenClaw. ## What you will do diff --git a/docs/install/kubernetes.md b/docs/install/kubernetes.md index 722c4fc982d..5155ddd1be2 100644 --- a/docs/install/kubernetes.md +++ b/docs/install/kubernetes.md @@ -6,8 +6,6 @@ read_when: title: "Kubernetes" --- -# OpenClaw on Kubernetes - A minimal starting point for running OpenClaw on Kubernetes — not a production-ready deployment. It covers the core resources and is meant to be adapted to your environment. ## Why not Helm? diff --git a/docs/install/podman.md b/docs/install/podman.md index c87386071e3..15ad89fa0e7 100644 --- a/docs/install/podman.md +++ b/docs/install/podman.md @@ -98,11 +98,11 @@ openclaw channels login On macOS, Podman machine may make the browser appear non-local to the gateway. If the Control UI reports device-auth errors after launch, use the Tailscale guidance in -[Podman + Tailscale](#podman--tailscale). +[Podman and Tailscale](#podman--tailscale). -## Podman + Tailscale +## Podman and Tailscale For HTTPS or remote browser access, follow the main Tailscale docs.