# Release and Publish Guide (v0.2.1)
## 1. Validate locally
```powershell
cargo fmt
cargo check --release
cargo run --release --bin benchmark_matrix
cargo package --allow-dirty
cargo publish --dry-run --allow-dirty
```
## 2. Commit and tag
```powershell
git add Cargo.toml Cargo.lock src/lib.rs README.md benchmark_results_matrix.md src/bin/benchmark_matrix.rs RELEASE.md
git commit -m "release: v0.2.1 adaptive edge-case heuristics and benchmark matrix"
git tag -a v0.2.1 -m "overclocked_sort v0.2.1"
```
## 3. Push to GitHub
```powershell
git push origin master
git push origin v0.2.1
```
## 4. Publish to crates.io
```powershell
cargo publish
```
## 5. Verify publication
- Crate page: https://crates.io/crates/overclocked_sort
- Docs page: https://docs.rs/overclocked_sort
If docs.rs cache lags, wait a few minutes and refresh.