beads/docs/integrations
Steve Yegge f215b312cf
docs: re-review and bump the three 90-day-stale freshness markers (#5394)
* 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.
2026-08-07 02:35:11 -07:00
..
aider.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
azure-devops.md docs: re-review and bump the three 90-day-stale freshness markers (#5394) 2026-08-07 02:35:11 -07:00
claude-code-plugin.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
claude-code.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
codex.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
cody.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
copilot-cli.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
cursor.md docs: align user docs and CLI reference with the v1.1.0 release (#4874) 2026-07-17 14:17:28 -07:00
factory.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
gemini.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
github-copilot.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
index.md [codex] Add Kiro setup recipe (#4535) 2026-07-27 22:28:43 -07:00
junie.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
kilocode.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
kiro.md [codex] Add Kiro setup recipe (#4535) 2026-07-27 22:28:43 -07:00
mcp-server.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
mux.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
opencode.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00
windsurf.md docs: apply PR #4722 review feedback to user docs 2026-07-12 11:06:57 -07:00