Use towncrier for change log

[StFroese]

closes #1995

[codecov]

Codecov Report

Base: 92.75% // Head: 92.76% // Increases project coverage by +0.00% 🎉

Coverage data is based on head (6b53984) compared to base (0e4ffea).
Patch coverage: 100.00% of modified lines in pull request are covered.

❗ Current head 6b53984 differs from pull request most recent head 383a3c6. Consider uploading reports for the commit 383a3c6 to get more accurate results

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #2144   +/-   ##
=======================================
  Coverage   92.75%   92.76%           
=======================================
  Files         216      216           
  Lines       18050    18045    -5     
=======================================
- Hits        16742    16739    -3     
+ Misses       1308     1306    -2     

Impacted Files	Coverage Δ
ctapipe/atmosphere.py	91.40% <ø> (ø)
ctapipe/calib/camera/calibrator.py	95.57% <ø> (ø)
ctapipe/coordinates/nominal_frame.py	89.65% <ø> (ø)
ctapipe/coordinates/telescope_frame.py	90.00% <ø> (ø)
ctapipe/core/container.py	93.02% <ø> (ø)
ctapipe/core/traits.py	93.43% <ø> (ø)
ctapipe/image/reducer.py	92.30% <ø> (ø)
ctapipe/instrument/subarray.py	89.09% <ø> (ø)
ctapipe/instrument/telescope.py	93.18% <ø> (ø)
ctapipe/io/eventsource.py	90.24% <ø> (ø)
... and 5 more

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.

[maxnoe]

I am not sure we really need the sub-directories for each submodule.

[StFroese]

This is just the astropy way of having sections in the change log. I can remove them and write all news fragments in the changes folder

[nbiederbeck]

I hesitate to review this, because I have no experience with towncrier or any other automatic changelog generation. What would the "Changes: Using towncrier" entry from this PR look like? Can you already include it in this PR?

I assume this PR can already include some developer documentation.

Apropos documentation: The Docs CI is failing.

[StFroese]

Ctapipe 0.17.1.dev320+gfe9162fe (2022-12-01)    
============================================    
    
    
API Changes    
-----------    
    
    
Bug Fixes    
---------    
    
    
Data Model Changes    
------------------    
    
    
New Feature    
-----------    
    
    
Maintenance    
-----------    
    
- Use towncrier for the generation of change logs [#2144]    
    
    
Refactoring and Optimization    
---------------------------- 

[StFroese]

Docs also fail on #2138 with the same error

[maxnoe]

Astropy has a CI that checks for the changelog entry or the label "no-changelog-needed".

Can you also add to the docs (or link to the astropy docs if identical) what the maintainers have to do for a new release?

[StFroese]

Yes I can add it to the readme in the changes folder. It's as simple as towncrier build --version=<VERSION NUMBER>

[StFroese]

This is what we want https://github.com/pllim/actions-towncrier-changelog

[StFroese]

The check requires this app https://github.com/Cadair/giles

[kosack]

I think now we just need to update the developer guide to explain how to use this. It can go in the making a pull request page (which in any case needs some updating).