Skip to content

Conversation

sg-writer
Copy link
Contributor

@sg-writer sg-writer commented Oct 2, 2025

this PR installs Vale with (most of) the Google style rules package to get us started. I made some changes throughout to make it more useful to us but there's definitely more to be done. This should be enough to start using Vale right away as a CI check.

I tried getting an LLM to fix the 500ish errors reported but it made a colossal mess so I had to revert all of those changes. We can start to actually apply the Vale rules in follow-up PRs.

The command to run it is pnpm run vale. There are lots of flags available to refine it.

Note: once this PR is merged we'll need to turn Vale back on in the Mintlify dashboard to get the CI checks.

@sg-writer sg-writer requested a review from S3Prototype October 17, 2025 19:17
Copy link
Collaborator

@S3Prototype S3Prototype left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I updated the readme and dependencies, since I was having some issues. Unfortunately it looks like we're going to just have to tell people to install vale separately, rather than have it bundled in with our project dependencies so they can just pnpm i.

Anyway, I think for now we should make it so vale doesn't block any PRs from merging until we do a separate PR to fix all the existing errors

@sg-writer
Copy link
Contributor Author

ah weird, didn't realize Vale had to be installed on your device in addition to the project itself. Thanks for addressing that.

I tried to get an LLM to address the errors and it failed miserably 🫠 so I'll try tackling that by hand.

@sg-writer sg-writer merged commit 1e893f8 into main Oct 20, 2025
2 checks passed
@sg-writer sg-writer deleted the sg/doc-428-set-up-vale-in-mintlify branch October 20, 2025 16:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs/infra Changes to the infrastructure of the docs site kind/enhancement New feature or improvement to the docs experience

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants