From 4128bac9bedda3f37917de84b12aaee4f527051c Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Sun, 25 Oct 2026 22:45:11 -0700 Subject: [PATCH 1/2] docs(audits): claim table skeleton, one section per first-touch page (TASK-008) Each child row of TASK-008 fills its own section, so the page PRs merge without conflicting. The pricing section records that the docs have no pricing page, and points at the landing section /pricing redirects to. Co-Authored-By: Claude Opus 5.5 Co-authored-by: wren Agent-Model: claude/claude-opus-5-5/max --- docs/audits/claim-table.md | 69 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 docs/audits/claim-table.md diff --git a/docs/audits/claim-table.md b/docs/audits/claim-table.md new file mode 100644 index 0000000000..c76e7b3963 --- /dev/null +++ b/docs/audits/claim-table.md @@ -0,0 +1,69 @@ +# Docs claim table + +One row per factual claim on a customer-facing page, each with one verdict and its evidence. The +rule is in [fleet-efficiency.md §6](../agents/fleet-efficiency.md#6-claims). Evidence is a walk on +prod with a 390 and a 1440 screenshot, or a `file:line` on `main`. It is no older than 14 days. A +claim past 14 days is re-walked in the next release batch, or it comes out. + +## Verdicts + +- **WALKED**: someone who did not write the claim did it on commonly.me. The evidence is a 390 and a + 1440 screenshot. +- **TRUE**: code on `main` does what the claim says. The evidence is a `file:line` on `main`, not + another doc. +- **STALE**: the feature or fact is gone. The same PR removes the claim. +- **FALSE**: the claim is wrong. The same PR fixes it or removes it. +- **CUT**: the claim was not walked in time. The same PR removes it, and it can come back with + evidence. + +Screenshots for this table go in `docs/audits/claim-table/
/`. No screenshot may show a +token, a command with a token in it, or an email address. + +Each page has its own section, and each page's PR edits only its own section. + +## README + +Owner: TASK-010. Source: `README.md`. + +| Page | Claim | Verdict | Evidence | Date | +|---|---|---|---|---| + +## Quickstart and introduction + +Owner: TASK-011. Source: `docs-site/quickstart.mdx` and `docs-site/introduction.mdx`. + +| Page | Claim | Verdict | Evidence | Date | +|---|---|---|---|---| + +## Bring your own agent + +Owner: TASK-012. Source: `docs-site/bring-your-own/index.mdx`, `claude-code.mdx`, `codex.mdx` and +`work-in-your-repo.mdx`, and the in-app setup at `commonly.me/v2/agents/byo`. + +| Page | Claim | Verdict | Evidence | Date | +|---|---|---|---|---| + +## Connectors and grants + +Owner: TASK-014. Source: `docs-site/concepts/connectors.mdx` and `docs-site/concepts/grants.mdx`. + +| Page | Claim | Verdict | Evidence | Date | +|---|---|---|---|---| + +## Self-host + +Owner: TASK-013. Source: `docs-site/deployment/index.mdx`, `docker.mdx`, `kubernetes.mdx` and +`environment-variables.mdx`. + +| Page | Claim | Verdict | Evidence | Date | +|---|---|---|---|---| + +## Pricing + +Owner: TASK-015. The docs site has no pricing page. `commonly.me/pricing` redirects to the landing +page's pricing section (`frontend/nginx.conf:36`), which renders at +`frontend/src/v2/landing/V2LandingPage.tsx:827` with its copy under `landing.pricing` in +`frontend/src/i18n/locales/en.json:981`. + +| Page | Claim | Verdict | Evidence | Date | +|---|---|---|---|---| From b9af1dc1a9d503d4e8052edbcab783d7fc2be5fc Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Sun, 25 Oct 2026 22:57:43 -0700 Subject: [PATCH 2/2] docs(audits): state the weekly re-walk of first-touch pages (TASK-008) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit fleet-efficiency.md §6 sets two clocks: evidence expires after 14 days, and the first-touch pages are re-walked every week. The table's intro named only the first. Co-Authored-By: Claude Opus 5.5 Co-authored-by: wren Agent-Model: claude/claude-opus-5-5/max --- docs/audits/claim-table.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/audits/claim-table.md b/docs/audits/claim-table.md index c76e7b3963..e2cccf1a58 100644 --- a/docs/audits/claim-table.md +++ b/docs/audits/claim-table.md @@ -3,7 +3,8 @@ One row per factual claim on a customer-facing page, each with one verdict and its evidence. The rule is in [fleet-efficiency.md §6](../agents/fleet-efficiency.md#6-claims). Evidence is a walk on prod with a 390 and a 1440 screenshot, or a `file:line` on `main`. It is no older than 14 days. A -claim past 14 days is re-walked in the next release batch, or it comes out. +claim past 14 days is re-walked in the next release batch, or it comes out. The first-touch pages +(quickstart, bring your own agent, connectors, self-host, pricing) are re-walked every week. ## Verdicts