Repository navigation
docs: prepare the docs workspace for iwe normalization - #75
Open
robfeldmann wants to merge 2 commits into
Open
robfeldmann wants to merge 2 commits into
robfeldmann wants to merge 2 commits into
Conversation
Fence the quoted Stability amendment in decision 9 (i) so iwe keeps it verbatim, make underscores the emphasis token the docs already use, render the plans hub in normalized form (checking it in a scratch copy of docs/), and add Slice 6.5 to plan 036.
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Intent
PR 1 of 3 for plan 036's new Slice 6.5 (the docs workspace in
iwe normalizeform, kept by a check). It removes the three things that break after an unscopediwe normalize, so the formatting-only PR (after #63 and #72 merge) can be purely mechanical, and adds the slice to the plan. No accepted issue: owner-directed maintenance (Q28, 2026-10-27).docs/research/decision-9i-application-contract.md: the quoted> ### Stabilityamendment becomes a fencedmarkdownblock. iwe re-leveled the quoted heading to> # Stability, which rumdl MD001 rejects, andrumdl --fixand iwe then rewrote each other.docs/.iwe/config.toml:emphasis_token = "_". The docs use_em_106 times and*em*ten times; iwe defaults to*.scripts/plans.py: the hub is rendered, then normalized withiwe normalize -k plans;--checkrenders and normalizes in a scratch copy ofdocs/and compares, so it never writes the workspace.docs/plans.mdis regenerated (its table is now padded).scripts/test_plans.pyis new andquality:plansruns it.mise.tomlandmise.lock: iwe 0.29.0 to 0.29.3 (output identical).Next:.User-visible behavior
None. Documentation, a Python script, and tool configuration.
Validation
On scratch copies under
/tmp, never in the worktree:iwe normalize -k research/decision-9i-application-contractleaves every heading as it was, the second run changes nothing, and rumdl passes (andrumdl --fixchanges nothing).iwe normalizeover the workspace keeps all 106_em_and converts the 7*em*in prose to_em_(the 3*x*matches inside code are untouched); with the old config it rewrote every_em_to*em*(0 left of 106).iwe normalize, thenplans.py --check, passes, and the normalizeddocs/plans.mdis byte-identical to the committed one. In the tree,plans.pythenplans.py --checkpasses.mise run quality:format,mise run quality:lint(includesquality:plansand its 6 new tests, andquality:wireframes), andiwe schema validatefromdocs/pass.Documentation and changelog
Plan 036 updated; no changelog entry (no user-visible change).
Compatibility
None.
Checklist