valelisted

# Vale Config keys: <https://vale.sh/docs/keys/>. Current Vale 3.x key set is: `BasedOnStyles, BlockIgnores, CommentDelimiters, IgnoredClasses, IgnoredScopes, MinAlertLevel, Packages, SkippedScopes, StylesPath, TokenIgnores, Transform, Vocab`. Anything else is stale. ## Comply, don't demote When a loaded rule fires, **rewrite the prose to comply** — don't demote or disable the rule. A firing rule is usually a real style nit worth adopting; restoring a package default typically costs zero current findings and often surfaces a legitimate fix (`Microsoft.Contractions` catching `does not` → `doesn't`). Demotion (`= suggestion`), disable (`= NO`), and scoping are the last resort, reserved for rules wrong for the writing style itself: - `Microsoft.Dashes` wanting tight em-dashes when the project's style uses spaced. - `Microsoft.HeadingColons` demanding sentence case after a colon when ADR/Nygard convention differs. Confirm the rule contradicts an intentional style choice before silencing it — inconvenience isn't enough. Tuning from the issue framing ("Vale fights writing, silence the noisy rules") rather than the actual per-finding cost is the failure mode this guards against. ## Defaults ```ini StylesPath = .vale/styles MinAlertLevel = warning Packages = Microsoft, proselint, alex Vocab = <Project> [*.md] BasedOnStyles = Vale, Microsoft, proselint, alex ``` - `StylesPath` — relative to `.vale.ini`. `.vale/styles` keeps the tree hidden. Commit `<StylesPath>/config/vocabu