<div dir="ltr"><div>In discussion with some other devs, I've realized that pulpcore and pulpcore-plugin would benefit from better release notes. Here are some of the reasons that have come up:</div><div><br></div><div>* The release notes are incomplete. One person tries to go through and write release notes just before the release happens, and by that point, the number of changes are too many for this approach to produce complete and robust notes.<br></div><div>* They are hard to produce. Producing "all the release notes" is a mentally difficult task. <br></div><div>* We try to substitute with Redmine, but this approach limits us (a) it's now difficult and time consuming to see what changed, (b) there is way more detail than you actually want, and they aren't self-contained (can't be browsed off-line).<br></div><div>* overall all ^ leads to both users and plugin writers feeling uncertain about what has changed in the last release, week, or even day.</div><div><br></div><div>So what can we do? Recently I contributed to aiohttp and I found their release note process light and easy. It produces high-quality release notes like these:  <a href="https://aiohttp.readthedocs.io/en/stable/changes.html">https://aiohttp.readthedocs.io/en/stable/changes.html</a></div><div><br></div><div>You can read about their process here:  <a href="https://aiohttp.readthedocs.io/en/stable/contributing.html#changelog-update">https://aiohttp.readthedocs.io/en/stable/contributing.html#changelog-update</a>  You can see some examples of these release note files in their repo here:  <a href="https://github.com/aio-libs/aiohttp/tree/master/CHANGES">https://github.com/aio-libs/aiohttp/tree/master/CHANGES</a>  Overall it makes use of the towncrier project <a href="https://github.com/hawkowl/towncrier">https://github.com/hawkowl/towncrier</a><br></div><div><br></div><div></div><div>What do you all think about trying something like this for pulpcore and pulpcore-plugin? Please write back on-list with thoughts, ideas, concerns, alternatives, etc.<br></div><div><br></div><div>Also, I made us a starter issue to coalesce some more of the practical aspect of adopting a change like this:  <a href="https://pulp.plan.io/issues/4875">https://pulp.plan.io/issues/4875</a></div><div><br></div><div>All the best,</div><div>Brian</div><div><br></div><div><br></div><div><br></div></div>