Closed GernotMaier closed 1 week ago
Project ID: gammasim_simtools_AY_ssha9WiFxsX-2oy_w
Project ID: gammasim_simtools_AY_ssha9WiFxsX-2oy_w
Project ID: gammasim_simtools_AY_ssha9WiFxsX-2oy_w
Project ID: gammasim_simtools_AY_ssha9WiFxsX-2oy_w
Project ID: gammasim_simtools_AY_ssha9WiFxsX-2oy_w
CTAO Software Programming Standards require having change logs in the software documentation (see description here).
This PR adds the functionality to use Towncrier to add entries to CHANGELOG.md for each release.
The functionality is the following:
Pull requests with changes relevant enough to be noted in the CHANGELOG should add a file containing a short summary of the changes to the docs/changes directory (these files are transient and deleted for each release). Possible categories are (here for the example of pull request #1234):
1234.feature.md
for new features1234.bugfix.md
for bug fixes1234.api.md
for changes to the API1234.doc.md
for documentation changes1234.maintenance.md
for maintenance changes1234.model.md
for changes to the simulation modelsee also the docs/changes directory of this branch.
Add these file to the pull request. The maintainer will use
towncrier
the generate the CHANGELOG for each release.Note that only items of interest for the user should be added to the CHANGELOG (not too technical).
Closes #1234