Skip to content

Contributing

Every commit needs a Developer Certificate of Origin sign-off. git commit -s adds it. CI rejects pull requests with unsigned commits.

CI runs these checks, and scripts/check.sh runs all of them locally. Run it before opening a pull request:

Terminal window
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace --all-targets
npx markdownlint-cli2 "**/*.md"

The parsers also have cargo-fuzz targets; fuzz/README.md shows how to seed and run them (cargo +nightly fuzz run <target>).

  • One logical change per commit. Keep refactors apart from behaviour changes.
  • Cite the draft section for spec-driven code, and update SPEC-MAP.md when a pinned revision changes.
  • Behaviour changes come with conformance vectors, negative cases included. Regenerate with VISADO_REGENERATE=1 cargo test --workspace and commit the result. See conformance/README.md.
  • Security checks fail closed and have negative tests.

Do not open a public issue. See SECURITY.md.