I am proposing to change up how Matplotlib's API changes/what's new pages
are generated, in particular moving to using towncrier
<https://github.com/hawkowl/towncrier> to add more automation to the
process. This is motivated by the crazy amount of time it took me to
combine all the API change and what's new fragments into a coherent page
for the 3.1.0 release.
The PR to change this process is here:
https://github.com/matplotlib/matplotlib/pull/14589 The new process would be
- When a new feature or api change or code removal is implemented, add a
changelog file to the *changelog/* folder
- The changelog file should be named <PR number>.<type>.rst, and should
contain a single sentence or paragraph describing the change. <type> is the
type of change, ie. api_change, new_feature or removal
- towncrier can then automatically collate these fragments into a single
.rst page, which can be manually edited if needed before releasing
I think this will significnatly reduce the burden of producing what's new
pages each release, without adding any extra burden on those writing the
what's new entries.
Please take a look at the PR and leave comments/questions/suggestions! In
particular, feedback on what "types" of changelog entry to include would be
All the best,
-------------- next part --------------
An HTML attachment was scrubbed...