Section tree

​

Structure

Section
├── heading_level   : 1..6
├── byte_range
├── line_range
├── parent_id, children_ids
├── word_count
├── artifact_counts : { code, table, image, diagram, math }
└── link_counts     : { internal, relative, external, broken }

​

Quality flags

​

How downstream metrics use the tree

• MCC reads heading-level changes to charge nesting penalties.
• Filler / Lazy Risk reads section sizes to detect “shallow big doc”.
• Section Balance penalizes oversized sections at the 95th percentile.
• Evidence Coverage computes per-section evidence anchor density.

​

References

• W3C: Web Content Accessibility Guidelines 2.1 — Heading levels — the source of the heading-skip quality flag (assistive-technology users rely on heading-level ordering).
• CommonMark Spec: ATX headings and setext headings — the parser-level definition the section tree builds on.

​

See also

• LOC family — feeds per-section line counts.
• Section Balance — balance scoring on the tree.