Example 1
A versioned release with concrete next steps
Improved
[2.0.0] — 2026-06-10
Added
- Async parser entry point:
parseAsync().
Changed
- Minimum supported Node.js version is now 20.
Removed
parseLegacy(); replace withawait parseAsync(input).
Deprecated
strictModeoption; usevalidation: "strict". Removal version is undecided.
Upgrade check
- Run parsing fixtures on Node 20 and verify rejected inputs are handled.
Why it works: Names the changed surface and includes a verification action rather than asking consumers to infer the migration.
Copy the markdown · replace illustrative details
## [2.0.0] — 2026-06-10
### Added
- Async parser entry point: `parseAsync()`.
### Changed
- Minimum supported Node.js version is now 20.
### Removed
- `parseLegacy()`; replace with `await parseAsync(input)`.
### Deprecated
- `strictMode` option; use `validation: "strict"`. Removal version is undecided.
### Upgrade check
- Run parsing fixtures on Node 20 and verify rejected inputs are handled.