Changelog automation

.github/pull_request_template.md

@@ -1,3 +1,18 @@
+<!--
+Thank you for pull request.
+Below are a few things we ask you kindly to self-check before getting a review. Remove checks that are not relevant.
+-->
+
+<!--
+Please note any issues this fixes using [closing keywords]( https://help.github.com/articles/closing-issues-using-keywords/ ):
+-->
+
+<!--
+see https://regro.github.io/rever-docs/news.html for details on how to add news entry (you do not need to run the rever command)
+-->
+
+Checklist
+* [ ] Added a ``news`` entry
 
 ## Developers certificate of origin
 - [ ] I certify that this contribution is covered by the MIT License [here](https://github.com/OpenFreeEnergy/openfe/blob/main/LICENSE) and the **Developer Certificate of Origin** at <https://developercertificate.org/>.

.gitignore

@@ -173,3 +173,6 @@ docs/ExampleNotebooks/
 
 # Some charge stuff
 *.model.pt
+
+# Rever
+rever/

docs/CHANGELOG.rst

@@ -0,0 +1,5 @@
+=================
+openfe Change Log
+=================
+
+.. current developments

docs/index.rst

@@ -65,13 +65,13 @@ The **OpenFE** toolkit provides open-source frameworks for calculating alchemica
 
         Reference guide on using the OpenFE CLI.
 
-    .. grid-item-card:: OpenFE Showcase
+    .. grid-item-card:: Changelog
         :img-top: _static/Showcase.svg
         :text-align: center
-        :link: tutorials/showcase_notebook
+        :link: CHANGELOG
         :link-type: doc
 
-        Tutorial notebook showing the sorts of things OpenFE can do.
+        Any notable changes in the package for each released version
 
     .. grid-item-card:: Relative Free Energy Protocol
         :img-top: _static/Rocket.svg
@@ -92,6 +92,7 @@ The **OpenFE** toolkit provides open-source frameworks for calculating alchemica
    guide/index
    cookbook/index
    reference/index
+   CHANGELOG
 
 Indices and tables
 ------------------

news/TEMPLATE.rst

@@ -0,0 +1,23 @@
+**Added:**
+
+* <news item>
+
+**Changed:**
+
+* <news item>
+
+**Deprecated:**
+
+* <news item>
+
+**Removed:**
+
+* <news item>
+
+**Fixed:**
+
+* <news item>
+
+**Security:**
+
+* <news item>

news/add_rever.rst

@@ -0,0 +1,23 @@
+**Added:**
+
+* use rever to manage changelog
+
+**Changed:**
+
+* <news item>
+
+**Deprecated:**
+
+* <news item>
+
+**Removed:**
+
+* <news item>
+
+**Fixed:**
+
+* <news item>
+
+**Security:**
+
+* <news item>

rever.xsh

@@ -0,0 +1,7 @@
+$PROJECT = $GITHUB_REPO = 'openfe'
+$GITHUB_ORG = 'OpenFreeEnergy'
+
+$ACTIVITIES = ['changelog']
+
+$CHANGELOG_FILENAME = 'docs/CHANGELOG.rst'
+$CHANGELOG_TEMPLATE = 'TEMPLATE.rst'