Problem
The hooks/plugins feature is fully implemented but has no user-facing documentation. Only a design document exists in docs/dev/hook_system.md.
Why not a simple move?
docs/dev/hook_system.md is written as a design document and needs adaptation:
- Remove "Design Document" framing and implementation details (CPEX references)
- Convert from architecture tone to how-to/tutorial tone
- Add practical examples and use cases
- Follow published docs conventions (frontmatter, no H1 in body, markdownlint compliance)
Files involved
- Adapt:
docs/dev/hook_system.md - Contains good explanations but needs user-facing rewrite
- Remove:
docs/dev/hook_system_implementation_plan.md - Internal implementation details
Tasks
- Create new published docs page(s) for hooks/plugins feature
- Adapt content from
docs/dev/hook_system.md (remove CPEX details, add examples)
- Ensure content follows published docs conventions
- Remove both dev docs after migration
Problem
The hooks/plugins feature is fully implemented but has no user-facing documentation. Only a design document exists in
docs/dev/hook_system.md.Why not a simple move?
docs/dev/hook_system.mdis written as a design document and needs adaptation:Files involved
docs/dev/hook_system.md- Contains good explanations but needs user-facing rewritedocs/dev/hook_system_implementation_plan.md- Internal implementation detailsTasks
docs/dev/hook_system.md(remove CPEX details, add examples)