# Release notes and templates

Release notes
- Historical release notes live under docs/releases/.
- Use release notes for time-specific changes; refer to docs2 for current behavior.

Determinism snippet template
- Use a deterministic score summary in release notes when publishing scans.

Template
```
- Determinism score: {{overall_score}} (threshold {{overall_min}})
  - {{image_digest}} score {{score}} ({{identical}}/{{runs}} identical)
- Inputs: policy {{policy_sha}}, feeds {{feeds_sha}}, scanner {{scanner_sha}}, platform {{platform}}
- Evidence: determinism.json and artifact hashes (DSSE signed, offline ready)
- Actions: rerun stella detscore run --bundle determinism.json if score < threshold
```

Related references
- release/release-engineering.md
- operations/replay-and-determinism.md
- docs/release/templates/determinism-score.md