1fe689a7bf
* docs: add mdBook and security documentation foundation * docs: point book links at storytold/photocraft; scope the credits entry The book's repository/edit URLs and source links pointed at the contributor's fork. The credits entry now describes what this PR contributed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --------- Co-authored-by: Brandon Thomas <echelon@gmail.com> Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
1.1 KiB
Testing
Tests are the gate for source changes. Choose the narrowest relevant package tests during development, then run the repository gates appropriate to the touched layers.
cargo test -p <package>
cargo clippy -p <package> --all-targets -- -D warnings
cargo xtask layers
For changes below or at L6, also run cargo xtask wasm. Command changes require the ignored adversarial test:
cargo test -p photocraft-engine --test panic_hunt -- --ignored
Format changes should include valid round trips, exact boundary values, truncation, inconsistent lengths, malformed structures, and allocation/decompression limit cases. Pixel behavior should be exercised at applicable 8-bit, 16-bit, and 32-bit depths.
UI changes need rendered evidence from the offscreen snapshot example or a control-channel screenshot. A successful build or HTTP response is not visual verification.
Documentation changes are verified with:
mdbook build book
Internal Markdown links and every SUMMARY.md destination should also be checked. The documentation workflow performs a clean mdBook build in CI.