[Infra] Update doc configuration to ignore check from certain files (#37)

Author: tang-mm

docs/.readthedocs.yaml

@@ -7,10 +7,10 @@ version: 2
 
 # Set the version of Python and other tools you might need
 build:
-  os: ubuntu-22.04
+  os: ubuntu-24.04
   apt_packages:
     - git-lfs
-    - libxkbcommon-dev
+    - libxkbcommon-dev   # YARF deps require xkbcommon>=1.4.1, Ubuntu-22.04 only has 1.4.0
   tools:
     python: "3.12"
   jobs:

docs/.sphinx/pa11y.json

@@ -5,5 +5,8 @@
     ]
   },
   "reporter": "cli",
-  "standard": "WCAG2AA"
+  "standard": "WCAG2AA",
+  "hideElements": [
+    "div.highlight pre"
+  ]
 }

docs/Makefile

@@ -145,7 +145,7 @@ vale: vale-install
 	@cat $(SPHINXDIR)/styles/config/vocabularies/Canonical/accept.txt > $(SPHINXDIR)/styles/config/vocabularies/Canonical/accept_backup.txt
 	@cat $(SOURCEDIR)/.custom_wordlist.txt >> $(SPHINXDIR)/styles/config/vocabularies/Canonical/accept.txt
 	@echo "Running Vale against $(TARGET). To change target set TARGET= with make command"
-	@. $(VENV); vale --config="$(VALE_CONFIG)" --filter='$(SPHINXDIR)/styles/error.filter' --glob='*.{md,rst}' $(TARGET)
+	@. $(VENV); vale --config="$(VALE_CONFIG)" --filter='$(SPHINXDIR)/styles/error.filter' --glob='*.{md,rst}' --glob='!reference/rf_libraries/**' $(TARGET)
 	@cat $(SPHINXDIR)/styles/config/vocabularies/Canonical/accept_backup.txt > $(SPHINXDIR)/styles/config/vocabularies/Canonical/accept.txt && rm $(SPHINXDIR)/styles/config/vocabularies/Canonical/accept_backup.txt
 
 spelling: vale-install