diff options
Diffstat (limited to 'doc/CONTRIBUTING.md')
| -rw-r--r-- | doc/CONTRIBUTING.md | 29 |
1 files changed, 26 insertions, 3 deletions
diff --git a/doc/CONTRIBUTING.md b/doc/CONTRIBUTING.md index 7d206a5..f41d90e 100644 --- a/doc/CONTRIBUTING.md +++ b/doc/CONTRIBUTING.md @@ -8,10 +8,33 @@ This document outlines the conventions to follow when contributing to this proje Before preparing or proposing a commit, you **must** perform the following verifications to prevent regressions: +**Automated Verification (Recommended):** +```bash +./scripts/check_all.sh +``` +This script automatically: +- Builds with tests and tools enabled +- Runs the full test suite (26 tests) +- Verifies all tools compile (spectool, specview, specplay) +- Cross-compiles for Windows (if mingw-w64 is installed) + +**Manual Verification:** + 1. **MacOS / Linux (Native)**: - * Build the project (debug or release). - * Run the entire test suite (`ctest`). - * Ensure all tests pass. + * Build the project with tests and tools enabled: + ```bash + cmake -S . -B build -DDEMO_BUILD_TESTS=ON -DDEMO_BUILD_TOOLS=ON + cmake --build build -j8 + ``` + * Run the entire test suite: + ```bash + cd build && ctest --output-on-failure + ``` + * Verify tools compile: + ```bash + cmake --build build --target spectool specview specplay + ``` + * Ensure all tests pass and all tools build successfully. 2. **Windows (Cross-Compilation)**: * If `mingw-w64` is installed on your system, you **must** also verify the Windows build. |