Skip to content

📖 docs: fix documentation rot - #350

Merged
hivecommons-hive[bot] merged 2 commits into
mainfrom
docs-rot-1023
Oct 23, 2026
Merged

hivecommons-hive[bot] merged 2 commits into
mainfrom
docs-rot-1023

Conversation

@clubanderson

Copy link
Copy Markdown
Member

Documentation-rot pass over every .md in this repo (docs only; no code, workflows or SECURITY.md).

Fixed

README vs CLI (src/cli-args.ts is the source of truth)

  • Added pluk version to the command table.
  • --run-dir row now lists every subcommand that accepts it (sessions, subscribe, watch, attach).
  • rationguard example bumped 0.11.0 → 0.13.0 (current release).

Stale / contradictory roadmap

  • ROADMAP.md: event-schema item marked shipped (v:1 envelope); removed the "Go and TypeScript relationship" section (there is no Go binary) → short Implementation note.

Runbooks vs release flow

  • release-rollback.md and publish-failure.md described a manual-tag flow; now describe auto-release.yml (version-bump merge → tag → dispatch publish.yml), with manual v* tag still supported, and the fix-forward steps reordered (fragment → bump + CHANGELOG section → merge).
  • session-monitoring-failure.md: "codex/aider have no bundled patterns" was stale; now points at pluk patterns --cli=<cli> and --patterns-dir for unsupported CLIs.

Not fixed / needs owner

  • None.

…ection

Signed-off-by: Andy Anderson <andy@clubanderson.com>
Signed-off-by: Andy Anderson <andy@clubanderson.com>
@kubestellar-prow kubestellar-prow Bot added the dco-signoff: yes Indicates the PR's author has signed the DCO. label Oct 23, 2026
@kubestellar-prow

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign kellyaa for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kubestellar-prow kubestellar-prow Bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Oct 23, 2026
@hivecommons-hive hivecommons-hive Bot added author/human A person pushed this PR themselves dco All commits are DCO signed-off role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Oct 23, 2026
@hivecommons-hive
hivecommons-hive Bot merged commit 21beccc into main Oct 23, 2026
13 of 14 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the docs-rot-1023 branch October 23, 2026 16:47
@hivecommons-hive

Copy link
Copy Markdown
Contributor
Evidence bundle `#35018cd997` sha256:0a281b1e315ade789302083a3cd5f2a072f7047162caaac85196fefe4a61bced — download from the dashboard or `hivectl review evidence #350`.

@hivecommons-hive

Copy link
Copy Markdown
Contributor

merged by Hive trusted-author auto-merge: author @clubanderson holds role owner and GitHub permission admin on repo; CI green at 18cd997.

@github-actions

Copy link
Copy Markdown

Thank you for your contribution! Your PR has been merged.

We'd love to hear how your experience was: share feedback

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author/human A person pushed this PR themselves dco All commits are DCO signed-off dco-signoff: yes Indicates the PR's author has signed the DCO. role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant