Skip to content

docs: add History user guide and configuration drift gate - #17

Merged
Xuepoo merged 2 commits into
mainfrom
cmd/user-docs
Oct 20, 2026
Merged

Xuepoo merged 2 commits into
mainfrom
cmd/user-docs

Conversation

@Xuepoo

@Xuepoo Xuepoo commented Oct 20, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds the canonical user guide for the official History plugin and a docs gate
that keeps the Configuration table in sync with the manifest.

Changes

  • Add the required user sections (Overview, Install, Commands,
    Configuration, Keybindings, Troubleshooting) ahead of the developer
    material.
  • Document the three read grants, opt-in capture, scoped query arguments, the
    four declared settings, and the typed E_HISTORY_* denials.
  • Add tests/check-docs.mjs and just docs-check: fail on a missing or extra
    documented setting, on type/default drift, and on a wrong user-section
    order.

Verification

  • just check passes locally (includes just docs-check).
  • Negative control: adding or removing a settings row fails the gate.

Priority: P2 | Area: plugin | Labels: docs, P2, area:plugin | Milestone: v0.1.0 | RFC: n/a | Task: n/a (user-facing plugin docs)

@Xuepoo Xuepoo added this to the v0.1.0 milestone Oct 20, 2026
@Xuepoo Xuepoo added docs P2 Normal priority area:plugin Plugin manifest and runtime surface labels Oct 20, 2026
@Xuepoo
Xuepoo merged commit dcded6c into main Oct 20, 2026
7 checks passed
@Xuepoo
Xuepoo deleted the cmd/user-docs branch October 20, 2026 02:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:plugin Plugin manifest and runtime surface docs P2 Normal priority

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant