# Changelog format

This reference defines the format for user-meaningful and methodology-meaningful changes. The sample below is a template, not a record of shipped features.

## Categories

Use these categories:

```txt
Added
Changed
Fixed
Security
Weather Sources
Algorithms
API
Deprecated
Removed
```

Algorithm and source changes deserve entries even when the visible interface does not change.

## Entry shape

```md
## YYYY-MM-DD

### Added

- Added NOAA MRMS MESH ingestion.
- Added event revision history.
- Added the property impact model.

### Weather Sources

- Added an MRMS product catalog revision.

### Algorithms

- Added event-boundary algorithm `event-boundary-v1.0.0`.
```

Create actual changelog entries only when a product, source, API, security, or methodology change occurs.