Skip to content

Adding vale#1716

Merged
pzaichkina merged 2 commits into
codatio:mainfrom
mcclowes:feat/vale
Dec 15, 2025
Merged

Adding vale#1716
pzaichkina merged 2 commits into
codatio:mainfrom
mcclowes:feat/vale

Conversation

@mcclowes
Copy link
Copy Markdown
Contributor

@mcclowes mcclowes commented Dec 15, 2025

@pzaichkina better than the readability scoring action from before. You can use https://vale.sh/ to validate against an actual styleguide


Note

Introduce Vale-based docs linting via GitHub Action, custom configuration, vocabulary, and npm scripts.

  • CI:
    • Add /.github/workflows/check-vale.yml to run errata-ai/vale-action on docs/** and blog/** for pushes/PRs, reporting via github-pr-review.
  • Tooling/Config:
    • Add .vale.ini with Google package, rule adjustments, and ignore patterns for MD/MDX.
    • Add custom vocabulary under .vale/styles/config/vocabularies/Codat/ (accept.txt, reject.txt).
  • Scripts:
    • Add vale:sync, vale, and vale:check npm scripts in package.json.

Written by Cursor Bugbot for commit 4d8e092. This will update automatically on new commits. Configure here.

@vercel
Copy link
Copy Markdown

vercel Bot commented Dec 15, 2025

@mcclowes is attempting to deploy a commit to the Codat Team on Vercel.

A member of the Team first needs to authorize it.

Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

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

This is the final PR Bugbot will review for you during this billing cycle

Your free Bugbot reviews will reset on December 20

Details

Your team is on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle for each member of your team.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

- name: Vale Linter
uses: errata-ai/vale-action@reviewdog
with:
files: docs
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Bug: Workflow triggers on blog but only lints docs

The workflow triggers on changes to blog/** in the paths section, but the files: docs parameter only lints the docs directory. When someone modifies blog content, the workflow runs but the blog files are never actually checked by Vale, defeating the purpose of having the trigger path. The files parameter likely needs to include both directories.

Additional Locations (2)

Fix in Cursor Fix in Web

Comment thread package.json
"format:mdx:check": "prettier --check \"**/*.{md,mdx}\"",
"vale:sync": "vale sync",
"vale": "vale docs/",
"vale:check": "vale --minAlertLevel=warning docs/"
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Bug: NPM vale scripts also exclude blog directory

The vale and vale:check npm scripts only lint the docs/ directory, excluding the blog/ directory. This is inconsistent with the workflow trigger paths which include both directories. When running Vale locally via npm scripts, blog content won't be checked, even though the repository has a blog/ directory used for documentation content.

Fix in Cursor Fix in Web

@vercel
Copy link
Copy Markdown

vercel Bot commented Dec 15, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
codat-docs Ready Ready Preview, Comment Dec 15, 2025 5:08pm

@pzaichkina pzaichkina enabled auto-merge December 15, 2025 17:05
@pzaichkina pzaichkina merged commit 1be572b into codatio:main Dec 15, 2025
5 of 9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants