Add API reference docs page

.gitignore

@@ -5,3 +5,4 @@ __pycache__
 /.vscode/
 .envrc
 .benchmarks
+site

docs/api.md

@@ -0,0 +1,3 @@
+# API Reference
+
+::: protovalidate

docs/index.md

@@ -0,0 +1,6 @@
+# Protovalidate
+
+Welcome to Protovalidate!
+
+View our [main documentation](https://protovalidate.com/quickstart-python/)
+or the generated [API reference](./api.md).

poe_tasks.toml

@@ -19,6 +19,14 @@ sequence = [
 help = "Check for uncommitted or untracked files (guards against codegen regressions)"
 shell = "test -z \"$(git status --porcelain | tee /dev/stderr)\""
 
+[tasks.docs-build]
+help = "Build documentation"
+cmd = "uv run --group docs zensical build"
+
+[tasks.docs-serve]
+help = "Start documentation local server"
+cmd = "uv run --group docs zensical serve"
+
 [tasks.generate]
 sequence = [
   "generate-cel",

protovalidate/_validator.py

@@ -141,7 +141,7 @@ def validate(
         Raises:
             CompilationError: If the static rules could not be compiled.
             ValidationError: If the message is invalid. The violations raised as part of this error should
-            always be equal to the list of violations returned by `collect_violations`.
+                always be equal to the list of violations returned by `collect_violations`.
         """
         coerced = self._coerce(message)
         violations = self.collect_violations(coerced, fail_fast=fail_fast)

pyproject.toml

@@ -64,6 +64,7 @@ dev = [
   # versions. Floored at 6.31.0 required by the cel-expr-python backend.
   "protobuf>=6.31.0",
 ]
+docs = ["mkdocstrings-python==2.0.5", "zensical==0.0.50"]
 
 [build-system]
 requires = ["hatch-vcs", "hatchling"]