Add Vale prose linting configuration

Set up Vale with Microsoft and write-good style packages for
automated documentation quality checks. Includes project-specific
vocabulary to prevent false positives on technical terms.

Usage: cd docs && vale sync && make docs-vale

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: jensens

.gitignore

@@ -27,3 +27,10 @@ dist/
 # Generated benchmark data (keep .gz seed files for CI/PGO)
 benchmarks/bench_data/*
 !benchmarks/bench_data/Data.fs.gz
+
+# Docs
+docs/html/
+docs/.mxmake/
+docs/.venv/
+docs/.vale/styles/Microsoft/
+docs/.vale/styles/write-good/

docs/.vale.ini

@@ -0,0 +1,21 @@
+StylesPath = .vale/styles
+MinAlertLevel = suggestion
+Packages = Microsoft, write-good
+Vocab = Project
+
+[*.md]
+BasedOnStyles = Vale, Microsoft, write-good
+
+# Vocabulary is for spelling acceptance only, not casing enforcement
+Vale.Terms = NO
+
+# Disable noisy rules that don't fit technical documentation
+Microsoft.Contractions = NO
+Microsoft.HeadingColons = NO
+Microsoft.Ellipses = NO
+
+# Ignore MyST colon-fence directives: :::note ... :::
+BlockIgnores = (?s)(:::\w[^\n]*\n.+?:::)
+
+# Ignore inline MyST/Sphinx roles: :ref:`target`, :doc:`path`, etc.
+TokenIgnores = (:[a-zA-Z][a-zA-Z0-9_-]*:`.+?`), (<[^>\n]+>)

docs/.vale/styles/config/vocabularies/Project/accept.txt

@@ -0,0 +1,144 @@
+# Projects and products
+Plone
+ZODB
+PostgreSQL
+Zope
+[Pp]ython
+Thumbor
+Docker
+Sphinx
+Volto
+Traefik
+Mermaid
+Sentry
+Kubernetes
+Ceph
+[Nn]ginx
+[Ss]ystemd
+
+# ZODB / Python ecosystem
+RelStorage
+ZEO
+FileStorage
+ZCatalog
+BTree[s]?
+PGJsonb
+GenericSetup
+CPython
+ParadeDB
+PyO3
+PyPI
+PyObject
+ZConfig
+mxmake
+
+# Rust / codec specific
+PickleValue
+BigInt
+OOBTree
+PersistentMapping
+IOBTree
+IIBTree
+[Ss]erde
+[Mm]aturin
+zodbpickle
+
+# Protocols / standards / acronyms
+CORS
+ZCML
+WSGI
+HTTP[S]?
+WebDAV
+HMAC
+SVG[s]?
+DNS
+LLVM
+CDN
+JSONB
+JSON
+XML
+SQL
+REST
+API[s]?
+URL[s]?
+BM25
+CJK
+GIL
+LRU
+MVCC
+TTL
+RAM
+PGO
+AST
+DDL
+HTML
+CSS
+OID[s]?
+TID[s]?
+IAM
+AWS
+
+# Tools and commands
+[Pp]sql
+psycopg
+uv
+rustup
+pytz
+
+# Technical terms
+tsvector
+autocommit
+[Dd]iataxis
+[Cc]ookiecutter
+async
+[Bb]oolean
+[Cc]odec
+[Cc]onfig
+enum[s]?
+lookups
+deque
+dicts
+bool
+args
+[Cc]odegen
+pickler
+memcpy
+tz
+Rc
+stdlib
+unicode
+booleans
+callables
+datetime[s]?
+defaultdict
+deserialization
+deserializ(e[s]?|ing)
+[Ff]rozenset[s]?
+inlining
+metastack
+OOBucket
+queryability
+queryable
+reallocations
+roundtrip(ping|s)?
+sanitization
+serde_json
+subcommand
+timedelta
+toolchain
+transcode[rs]?
+transcoding
+[Uu]ntrusted
+zoneinfo
+
+# Benchmark names
+btree_length
+btree_small
+bytes_in_state
+deep_nesting
+large_flat_dict
+nested_dict
+scalar_string
+simple_flat_dict
+special_types
+wide_dict

docs/include.mk

@@ -0,0 +1,14 @@
+# Vale prose linting
+
+VALE_BIN?=vale
+VALE_FLAGS?=--no-exit
+
+.PHONY: docs-vale
+docs-vale: $(DOCS_TARGET)
+	@echo "Run Vale prose linter"
+	@$(VALE_BIN) $(VALE_FLAGS) $(DOCS_SOURCE_FOLDER)
+
+.PHONY: docs-vale-sync
+docs-vale-sync:
+	@echo "Sync Vale styles"
+	@$(VALE_BIN) sync