Each of these would send a user down a path Vale does not support: Core options placed under a glob header are not scoped to that glob — Vale rejects them with E201, so the guidance to nest them produced a config that will not load. The built-in `Vale` style is compiled in, but Vale still requires StylesPath to exist on disk before it will run, so the "no StylesPath needed" shortcut fails. The MDX guidance was inverted: under `[formats] mdx = md` the mapping is what makes MDX lint at all, and it needs the mdx2vast prerequisite that was never mentioned. And a spelling rule's `ignore` paths resolve against StylesPath, not against the rule file's own directory, so the documented relative paths silently matched nothing.
1.6 KiB
1.6 KiB
Sources
context7-websites-vale-sh
- URL: context7:/websites/vale_sh
- Description: Official Vale documentation site (vale.sh) indexed by Context7 —
.vale.iniconfig reference, style/rule/check model, CLI commands and flags, installation across package managers and Docker, format-specific inline disable syntax, pre-commit integration, spelling ignore lists. - Research doc: plugins/lint/docs/research/docs/vale/sources.md
- Contributing files: SKILL.md, references/troubleshooting.md
- Status:
extracted
house-vale-3-15-2-repro
- URL: (house-verified — reproduced locally against the
valebinary, not an external source) - Description: Behaviour of Vale 3.15.2 established by running it against purpose-built fixtures in this repo, where vale.sh documents nothing or documents it wrongly:
.mdxhas no built-in support and needs either[formats] mdx = mdor an externalmdx2vastbinary (absent, the whole invocation exits 2 withE100 [lintMDX]), the inline-suppression form inverts between those two configurations, thespellingcheck'signorepaths resolve againstStylesPathor the working directory but never against the rule file's own directory and fail silently when they resolve nowhere,ls-configreports styles and paths but never rules, and thetext.frontmatter.<key>scope matrix across multi-line YAML forms. - Research doc: none — house-verified reproduction, not part of the plugin's research corpus (no
plugins/lint/docs/research/topic file backs this entry) - Contributing files: SKILL.md, references/troubleshooting.md
- Status:
extracted