* docs: re-review and bump the three 90-day-stale freshness markers
azure-devops.md, json-schema.md, and otel-data-model.md all carried
Last reviewed: 2026-05-08 — exactly 91 days old today, so the doc-flags
freshness gate went red on every branch at once. Each doc was genuinely
re-reviewed against its Freshness source paths on main; drift found and
fixed:
- azure-devops.md: proxied-server mode note (ado sync/status/projects
hard-error there); --parent and --project flags documented; duplicate
--issues row dropped; real ado.org error text quoted; ado.pat's
yaml-only secret storage noted. Source bug found during review filed
separately: the cmd-level config reader cannot see a yaml-only PAT,
so the documented Quick Start fails on main (bd-wvf77).
- json-schema.md: bd show/close/update --json return top-level ARRAYS
(contract-test-pinned); jq recipes fixed accordingly; envelope
pagination key documented; show's always-present revision field and
import's unchanged counter added; error envelope (optional code/hint,
envelope-mode shape, stdout paths, exit 1) corrected; deprecation
notice's tty-only condition noted.
- otel-data-model.md: hard opt-in via BD_OTEL_ENABLED + standard OTel
SDK env vars (BD_OTEL_* legacy); console-only trace export; dolt span
attrs (shared doltSpanAttrs, dolt.remote, dolt.force_push,
dolt.conflicts, dolt.merge_with_strategy); facade-wave storage role
spans; seven new Dolt metrics; AI attrs (bd.ai.duration_ms, 4-attempt
retry); appendix re-pinned to current main.
scripts/check-doc-freshness.sh passes locally.
* docs(otel): complete claim_verify_lost op label enumeration; qualify retry policy as compact-only
Review findings on #5394: op also takes guarded-update
(claim_verify.go:113) and ready-claim (issues.go:439); the retry-policy
sentence describes compact's loop, find_duplicates makes one unretried
call.