Attempt to get docs CI to pass (#6377)

Merging to unblock #6375

.github/workflows/docs.yml

@@ -10,6 +10,9 @@ on:
     paths:
       - 'docs/**'
       - 'styles/**'
+      - '.github/workflows/docs.yml'
+      - 'requirements-docs.txt'
+      - '.vale.ini'
 
 jobs:
   docs:
@@ -31,9 +34,7 @@ jobs:
         run: pip install virtualenv
 
       - name: pip install requirements
-        run: |
-          pip install -r requirements-docs.txt
-          sudo snap install --edge vale
+        run: pip install -r requirements-docs.txt
 
       - name: Check for broken links
         run: make docs-linkcheckbroken
@@ -42,7 +43,4 @@ jobs:
         run: make docs-html
 
       - name: Run vale
-        run: |
-          git clone https://github.com/errata-ai/Microsoft.git
-          cp -r ./Microsoft/Microsoft ./styles
-          vale --no-exit ./docs
+        run: make docs-vale VALEOPTS=--no-exit

Makefile

@@ -27,6 +27,7 @@ TESTING_ADDONS=plone.app.robotframework==2.0.0 plone.app.testing==7.0.0
 # Sphinx variables
 # You can set these variables from the command line.
 SPHINXOPTS      ?=
+VALEOPTS        ?=
 # Internal variables.
 SPHINXBUILD     = $(realpath bin/sphinx-build)
 SPHINXAUTOBUILD = $(realpath bin/sphinx-autobuild)
@@ -149,7 +150,7 @@ docs-linkcheckbroken: bin/python  ## Run linkcheck and show only broken links
 .PHONY: docs-vale
 docs-vale:  ## Run Vale style, grammar, and spell checks
 	vale sync
-	vale --no-wrap $(VALEFILES)
+	vale --no-wrap $(VALEOPTS) $(VALEFILES)
 	@echo
 	@echo "Vale is finished; look for any errors in the above output."
 

news/6377.documentation

@@ -0,0 +1 @@
+Install Vale via pip, and pin to <3.0.0, allowing it to run locally and in CI without reconfiguration. @stevepiercy

requirements-docs.txt

@@ -18,3 +18,4 @@ sphinxcontrib-htmlhelp==2.0.1  # https://github.com/plone/documentation/issues/1
 sphinxcontrib-qthelp==1.0.3  # https://github.com/plone/documentation/issues/1604
 sphinxcontrib-serializinghtml==1.1.5  # https://github.com/plone/documentation/issues/1604
 sphinxcontrib-video
+vale<3.0.0