From c47a1b13e021cea4c6d61c8a7a2643bd27100fce Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Thu, 21 May 2026 00:21:29 +0500 Subject: [PATCH] docs(concepts): add checklist rule #8 (Location column factual accuracy) Co-Authored-By: Claude --- .../best-practice/concepts/verification-checklist.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/changelog/best-practice/concepts/verification-checklist.md b/changelog/best-practice/concepts/verification-checklist.md index 46d7759..900f38d 100644 --- a/changelog/best-practice/concepts/verification-checklist.md +++ b/changelog/best-practice/concepts/verification-checklist.md @@ -59,3 +59,11 @@ Rules for verifying CONCEPTS table accuracy. Each rule is checked during every w - **Source to compare against**: Official docs page banner text + GA-marker copy - **Date added**: 2026-04-26 - **Origin**: Workflow-concepts-agent flagged Routines, No Flicker Mode, Computer Use, and Code Review as carrying README beta badges while their docs pages read as GA (confidence 0.6) — this drift type isn't covered by the existing description-currency rule + +### 8. Location Column Factual Accuracy +- **Category**: Description Accuracy +- **What to check**: Each concept's **Location** column (column 2) value must factually match the mechanism described in the official docs — not merely that the path/command/flag exists, but that the characterization is correct (e.g. how a feature stores state, what it tracks, where config lives) +- **Depth**: For any Location value that makes a mechanism claim (e.g. "git-based", "automatic", "built-in (env var)", "cloud backend"), fetch the official page and confirm the claim against the docs' own description of the mechanism +- **Source to compare against**: Official docs page body (mechanism/"how it works" sections) +- **Date added**: 2026-05-21 +- **Origin**: Checkpointing Location read `automatic (git-based)` for every prior run, but `/en/checkpointing` explicitly states checkpoints track file-editing-tool changes (not git, not bash) and are "not a replacement for version control" — *"checkpoints as 'local undo' and Git as 'permanent history'."* Existing rule #5 (Description Currency) only inspects the Description column, so a factual error in the Location column went unchecked indefinitely