Repository navigation
Closed
Labels
closed-outVerified and closed outVerified and closed outdocumentationImprovements or additions to documentationImprovements or additions to documentation
Description
Part of the docs overhaul epic #5467. Operator direction 2026-11-17: "I am pretty sure there are huge gaps in our documentation and lots of stuff that is outdated, I want a thorough cleanup and really get documentation into tip top shape."
The feature inventory checked which features have docs, not whether each page is accurate. This issue is a line-by-line accuracy audit of every published page in the Overdeck Anywhere nav group (21 pages) against current main (v0.88 or later).
Pages
-
anywhere.mdx -
configuration/session-vault.mdx -
configuration/remote-access.mdx -
configuration/linked-machines.mdx -
configuration/shared-sessions.mdx -
configuration/triggers.mdx -
configuration/tailscale.mdx -
configuration/mcp.mdx -
configuration/bots.mdx -
configuration/phone.mdx(also edited by docs: fix published pages that contradict the product (state branch, Cloister routing, Inspect, phone apps, introduction) #5472: audit it after that PR merges, on top of its result) -
configuration/push-notifications.mdx -
cli/vault.mdx -
cli/pair.mdx -
cli/tailscale.mdx -
cli/account.mdx -
cli/share.mdx -
cli/devices.mdx -
cli/machines.mdx -
cli/token.mdx -
cli/mcp.mdx -
cli/triggers.mdx
For each page
- Read the whole page. List every factual claim: commands and flags, config keys and defaults, UI labels and locations, file paths, behavior, limits, supported harnesses/trackers/platforms, maturity.
- Verify each claim against current code (
git grep),pan <verb> --help,src/lib/config-yaml/defaults.ts, the dashboard source, andchangelog.mdx. Do not trust other docs pages as proof; several are stale. - Fix wrong claims, delete claims about removed features, and add what a user needs that is missing (short; link to the dedicated page instead of duplicating it). Label early, experimental (Settings → Experimental) and testing features as such.
- Frontmatter: specific searchable
title,description50 to 160 characters, no em or en dashes in either. Remove em dashes from the body too. - Check every link on the page resolves.
- Tick the page above in the PR body with a one-line note of what changed (or "verified, no change").
Every PR for this issue
- Run the Mintlify validator (
npx mint validateor the current equivalent) and the link check (npx mint broken-links) and paste the clean result in the PR body. - Zero U+2013/U+2014 in titles and descriptions of the touched pages.
- Docs-only: no changelog.d entry unless behavior changed.
- Where a page talks about getting help, link the Overdeck Discord (https://discord.gg/ZpHE2ZTv5P) and GitHub Issues.
Metadata
Metadata
Assignees
Labels
closed-outVerified and closed outVerified and closed outdocumentationImprovements or additions to documentationImprovements or additions to documentation
Activity
eltmon commentedon Nov 17, 2026
Known stale item for this audit (from the site critic, 2026-11-17):
configuration/triggers.mdxstill says webhook triggers are "Available from the next release". Check the shipped state and fix the wording.eltmon commentedon Nov 19, 2026
🤖 Agent completed work:
docs: accuracy audit of the Overdeck Anywhere docs group (21 pages). No deviations from the PRD. All 24 page/validation items complete, each committed and pushed separately. Validators (dash rule, stale-release check, frontmatter, help-link, lint:docs, mint validate, mint broken-links) all pass; 3 pre-existing broken links and 23 pre-existing duplicate-h1 warnings outside or unrelated to this change are noted as Follow-ups, not fixed. PR body draft with the 21 page lines and validation output is in the validate-and-pr-body commit message, to be appended to the PR body.
eltmon commentedon Nov 19, 2026
Closed via close-out ceremony
Definition of Done
Gate: passed