Problem
apps/hocuspocus.server/API.md uses "section" for two rules.
- The changes route and the MCP section body use one rule: a heading plus the top-level nodes up to the next heading of any level (§The section tree, and §MCP "Section rules").
CONTEXT.md already names this rule Section.
- The caller-side rule and the
get_outline tree use another: a heading holds every later node up to the next heading of the same or a smaller level ("A section is a caller-side rule", and the get_outline row).
Readers mistook the second meaning for a defect twice.
What to do
Give the caller-side rule its own name, for example Heading subtree. Use it in both places in API.md, and add it to CONTEXT.md next to Section. Documentation only.
Acceptance
Notes
Related to #163. This issue does not wait on it.
Problem
apps/hocuspocus.server/API.mduses "section" for two rules.CONTEXT.mdalready names this rule Section.get_outlinetree use another: a heading holds every later node up to the next heading of the same or a smaller level ("A section is a caller-side rule", and theget_outlinerow).Readers mistook the second meaning for a defect twice.
What to do
Give the caller-side rule its own name, for example Heading subtree. Use it in both places in
API.md, and add it toCONTEXT.mdnext to Section. Documentation only.Acceptance
API.mduses "section" only for the any-level rule.get_outlinerow use the new name.CONTEXT.mddefines the new name and says how it differs from Section.Notes
Related to #163. This issue does not wait on it.