Contributing
Sign-off
Section titled “Sign-off”Every commit needs a Developer Certificate of Origin sign-off. git commit -s adds it. CI rejects pull requests with unsigned commits.
Checks
Section titled “Checks”CI runs these checks, and scripts/check.sh runs all of them locally. Run it before opening a pull request:
cargo fmt --all -- --checkcargo clippy --workspace --all-targets -- -D warningscargo test --workspace --all-targetsnpx 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>).
Guidelines
Section titled “Guidelines”- 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 --workspaceand commit the result. See conformance/README.md. - Security checks fail closed and have negative tests.
Security issues
Section titled “Security issues”Do not open a public issue. See SECURITY.md.
© 2026 The visado Authors. Licensed under Apache-2.0.
Third-party logos are trademarks of their respective owners and are used to show compatibility; their use does not imply endorsement.