WORK-658
ID:WORK-658Status:ready

Indent nested runes in site content with refrakt format

The documentation site is the largest body of refrakt content in the repository, and the first place a reader copies examples from. Once WORK-657 can apply SPEC-170 D5 mechanically, run it over the site, so nested runes read as nested and the examples teach the rule.

Priority:mediumComplexity:simpleMilestone:v0.42.0Source:SPEC-170
claude/v0-42-0-planning-ata7nd View source

Criteria completion

Criteria completion: 0 of 5 (0%) checked; tracking started on Oct 22, no incremental history yet0%25%50%75%100%Oct 22Oct 28

Tracking started Oct 22 — check back for trends.

Branches 3
History 1
  1. f7f9792
    Created (ready)by bjornolofandersson

Acceptance Criteria

  • refrakt format has been run over site/content/, in a commit of its own that contains nothing else
  • Every changed file parses to the same AST as before, and the site's rendered HTML is byte-identical, asserted once for the whole site
  • Rune examples inside fences in the docs follow the rule too, where they show nesting
  • refrakt format --check covers site/content/ in CI from this point
  • The resolution records how many files changed and confirms that plan/ needed no changes

Approach

The formatter refuses a file whose AST would change, so a refused file is a finding: either the formatter has a bug, or the file relied on the old indentation behaviour. Record each one in the resolution and fix it before the run is committed.

Blocked by

  • WORK-657

References

  • SPEC-170: D4, D5.