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
changeset-release/main View source

Criteria completion

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

Tracking started Oct 24 — check back for trends.

Branches 3
History 1
  1. 65f872e
    Created (ready)by github-actions[bot]

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.