name: prepare-changelog-release description: Prepares the CHANGELOG.md file for release by updating the [Unreleased] section with the current plugin version and date. Use when the user asks to prepare changelog for release, update changelog for release, or finalize changelog entries.
Prepare Changelog for Release
Updates the unreleased section of CHANGELOG.md with the current plugin version and date, following the project's changelog format.
Instructions
When preparing the changelog for release:
-
Read the current plugin version from
publishpress-hub-statistics.php(Version field in the file header) -
Read CHANGELOG.md to identify:
- The [Unreleased] section (typically starts at line 4)
- All entries under [Unreleased] (bullet points between [Unreleased] and the next version)
-
Update the changelog by replacing the [Unreleased] header with:
[VERSION] - DD MMM, YYYYWhere:
- VERSION is the current version from the plugin file
- DD is the day (2 digits)
- MMM is the month (3-letter abbreviation: Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec)
- YYYY is the 4-digit year
-
Add a new [Unreleased] section at the top (after line 3) with empty content:
[Unreleased]
Format Requirements
- Use exactly one blank line between sections
- Maintain the existing bullet point format for entries
- Follow the format:
[VERSION] - DD MMM, YYYY(e.g.,[1.0.0] - 02 Feb, 2026) - Add comma after day in the date
- Use 3-letter month abbreviation
Example Transformation
Before:
The format is based on [Keep a Changelog](http://keepachangelog.com/)
and this project adheres to [Semantic Versioning](http://semver.org/).
[Unreleased]
- Added: New feature X
- Fixed: Bug in feature Y
[1.0.0] - 02 Feb, 2026
After (assuming version 1.1.0 and date 05 Feb, 2026):
The format is based on [Keep a Changelog](http://keepachangelog.com/)
and this project adheres to [Semantic Versioning](http://semver.org/).
[Unreleased]
[1.1.0] - 05 Feb, 2026
- Added: New feature X
- Fixed: Bug in feature Y
[1.0.0] - 02 Feb, 2026
Month Abbreviations Reference
| Month | Abbreviation |
|---|---|
| January | Jan |
| February | Feb |
| March | Mar |
| April | Apr |
| May | May |
| June | Jun |
| July | Jul |
| August | Aug |
| September | Sep |
| October | Oct |
| November | Nov |
| December | Dec |