Merge pull request #22258 from backstage/freben/vale-3

bump to vale 3

.github/workflows/verify_docs-quality.yml

@@ -30,6 +30,6 @@ jobs:
         with:
           # This also contains --config=.github/vale/config.ini ... :/
           files: '${{ steps.generate.outputs.args }}'
-          version: 2.30.0 # TODO: migrate to v3
+          version: latest
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

CONTRIBUTING.md

@@ -386,7 +386,7 @@ Here are a few things that can help as you go through the review process:
 - PRs get automatically assigned so you don't need to ping people, they will be notified and have a process of their own for this
 - If you are waiting for a review or mid-review and your PR goes stale one of the easiest ways to clear the stale bot is by simply rebasing your PR
 - There are times where you might run into conflict with the `yarn.lock` during a rebase, to help with that make sure your `master` branch is up to date and then in your branch run `git checkout master yarn.lock` and then run `yarn install`, this will get you a conflict free `yarn.lock` file you can commit
-- If Vale finds issues with your documentation but it's a code reference you can fix it by putting backticks (`) around it. Now if it is a special word or maybe a name there are two ways you can fix that by adding it to the list of accepted words in the [accept.txt file](https://github.com/backstage/backstage/blob/master/.github/vale/Vocab/Backstage/accept.txt) and them committing that change
+- If Vale finds issues with your documentation but it's a code reference you can fix it by putting backticks (`) around it. Now if it is a special word or maybe a name there are two ways you can fix that by adding it to the list of accepted words in the [accept.txt file](https://github.com/backstage/backstage/blob/master/.github/vale/config/vocabularies/Backstage/accept.txt) and them committing that change
 
 ### Merging to Master
 

scripts/check-docs-quality.js

@@ -70,7 +70,7 @@ async function exitIfMissingVale() {
       process.exit(1);
     }
     console.log(`Language linter (vale) generated errors. Please check the errors and review any markdown files that you changed.
-  Possibly update .github/vale/Vocab/Backstage/accept.txt to add new valid words.\n`);
+  Possibly update .github/vale/config/vocabularies/Backstage/accept.txt to add new valid words.\n`);
     process.exit(0);
   }
 }
@@ -89,7 +89,7 @@ async function runVale(files) {
     // If it contains system level error. In this case vale does not exist.
     if (process.platform !== 'win32' || result.error) {
       console.log(`Language linter (vale) generated errors. Please check the errors and review any markdown files that you changed.
-  Possibly update .github/vale/Vocab/Backstage/accept.txt to add new valid words.\n`);
+  Possibly update .github/vale/config/vocabularies/Backstage/accept.txt to add new valid words.\n`);
     }
     return false;
   }