Skip to content

feat(guides): add sections option for Redoc sidebar grouping #3767

@PierreBrisorgueil

Description

@PierreBrisorgueil

Promote-up from trawl_node: mergeGuidesIntoSpec gains an optional third argument { sections } that groups guides under H1 dividers (each guide rendered as H2) using filename numeric prefix ranges.

When sections is not passed, behavior is identical to today's flat mode (backward-compatible). When passed, every downstream with a structured doc tree gets Redoc sidebar grouping for free.

Adds prefixFromPath helper (exported) to extract the numeric ordering prefix from a guide filename (e.g. 07-scheduling.md → 7) — used by the sectioned routing logic.

References: trawl_node#1320 (3 drift files — this file is one of the three). Part of infra plan 2026-06-01-trawl-promote-up-followups.md.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions