[docs-infra] Fix Vale no longer working

[oliviertassinari]

I was working on a quick fix, mui/mui-x#17538. There I noticed in MUI X that Vale was reporting 100 errors https://github.com/mui/mui-x/actions/runs/14686411363/job/41215568904.

but it was strange as I don't get those in Material UI nor if I run the script locally. However, in Material UI, it just crashes: https://github.com/mui/material-ui/actions/runs/14682247158/job/41206345211

as it turned out, it was a pile of problems, and broken for some time:

1. The markdown yaml headers we have are not valid YAML, can be verified in https://www.yamllint.com/. It needs to be properly escaped. A quick intro in https://symfony.com/doc/current/reference/formats/yaml.html#strings.
2. But it also means that the conversion logic needs to be fixed to support it.
3. We have no versioning on the version of vale that the GitHub action runs. It's "latest". Let's force a version, using https://github.com/errata-ai/vale-action?tab=readme-ov-file#version-default-latest.
4. Now, with this fixed, we can reproduce the 100 errors. I have fixed this by having the substation match the spacing.
5. It seems that we have 4 versions of Vale to sync npm package errata-ai/vale#829 (comment). Starting to use an npm version to more easily version and reproduce result between envs.
6. Rules started to diverge between Material UI and MUI X, because it was broken in X we didn't saw it until now, fixed the charts rules.

🧹 done. The last thing would be to have 1. the Vale VS Code extension use the binary available locally 2. an official npm version, maybe one day.

---

Next:

• Update each repo. Update .github/workflows/vale-action.yml, update package.json, update pnpm-workspace.yaml.

[mui-bot]

Netlify deploy preview

https://deploy-preview-46029--material-ui.netlify.app/

Bundle size report

No bundle size changes (Toolpad)
No bundle size changes

Generated by 🚫 dangerJS against 914eb78

[alexfauquette]

Those one are correct. we agree on the fact that those item does not need an extra "chart"

Suggested change

	Sparkline Chart: Sparkline chart
	Gauge Chart: Gauge chart
	Treemap Chart: Treemap chart
	Sparkline Chart: Sparkline
	Gauge Chart: Gauge
	Treemap Chart: Treemap

[oliviertassinari]

I did the change because of https://github.com/mui/mui-x/pull/17602/files#r2067364155. It doesn't seem that we can do anything about it. We have to allow it.

[alexfauquette]

Is their a specific reason why using " instead of ' ?

[oliviertassinari]

The other valid YAML syntax would be:

Suggested change

	title: "The 2019 Material UI Developer Survey: here's what we discovered"
	title: 'The 2019 Material UI Developer Survey: here''s what we discovered'

I was lazy, didn't add support for the '' escaping.

[alexfauquette]

Why removing those lines?

[oliviertassinari]

The goal is to keep the test more focused on what we try to test, this is unrelated.

[alexfauquette]

I've open a PR to test it on MUI X mui/mui-x#17602