From 9525ee01b5b45092afe5ed93fd7908eb3fccd85e Mon Sep 17 00:00:00 2001
From: Stefan van der Walt <stefanv@berkeley.edu>
Date: Fri, 11 Sep 2026 22:31:40 +0000
Subject: [PATCH] Move release notes to CHANGELOG.md

The format is now Markdown.

Assisted-by: claude-code:claude-opus-5
---
 .../release-notes.rst => CHANGELOG.md         | 18 ++++++-------
 RELEASE.md                                    | 25 ++++++++++++++-----
 doc/source/dev/index.rst                      |  6 ++++-
 pyproject.toml                                |  1 +
 4 files changed, 33 insertions(+), 17 deletions(-)
 rename doc/source/_includes/release-notes.rst => CHANGELOG.md (82%)

diff --git a/doc/source/_includes/release-notes.rst b/CHANGELOG.md
similarity index 82%
rename from doc/source/_includes/release-notes.rst
rename to CHANGELOG.md
index 3e0683d..4a4325f 100644
--- a/doc/source/_includes/release-notes.rst
+++ b/CHANGELOG.md
@@ -1,20 +1,18 @@
-Release Notes
--------------
-1.1.0
-~~~~~
+# 1.1.0
+
 * **1.1.0 is not released yet.**
 
-1.0.0
-~~~~~
+# 1.0.0
+
 * The transition of the source code from NumPy to this package is complete.
 
-0.2.0
-~~~~~
+# 0.2.0
+
 * Removed the use of `numpy.core.overrides.array_function_dispatch` to create
   wrappers of the financial functions.
 * Support NumPy versions back to 1.15.
 
-0.1.0
-~~~~~
+# 0.1.0
+
 * This is the initial release of numpy-financial.  The functions were
   copied from NumPy 1.17.
diff --git a/RELEASE.md b/RELEASE.md
index 5a42be4..9db841c 100644
--- a/RELEASE.md
+++ b/RELEASE.md
@@ -23,16 +23,25 @@ PyPI trusted publishing. Do not build or upload artifacts by hand.
       export PREVIOUS=<previous version number>
       export ORG="numpy"
       export REPO="numpy-financial"
-      export NOTES="doc/source/_includes/release-notes.rst"
+      export NOTES="CHANGELOG.md"
+      export CHANGES="${VERSION}.md"
 
 - Make sure the test suite is green on `main`, for all operating systems
   and Python versions in `.github/workflows/pythonpackage.yml`.
 
-- Write the release notes for ${VERSION} at the top of the version list in
-  ${NOTES}. To get a list of the merged pull requests since the last
-  release:
+- Generate the list of merged pull requests since the last release:
 
-      changelist ${ORG}/${REPO} v${PREVIOUS} main --version ${VERSION} --config pyproject.toml
+      changelist ${ORG}/${REPO} v${PREVIOUS} main --version ${VERSION} --config pyproject.toml --out ${CHANGES}
+
+  ${CHANGES} is a scratch file. Keep it until the GitHub release is
+  made, then delete it. Do not commit it.
+
+- Put the generated notes at the top of ${NOTES}:
+
+      cat ${CHANGES} | cat - ${NOTES} > temp && mv temp ${NOTES}
+
+  Then edit the new section: keep what is useful to a reader, and remove
+  the rest.
 
 - Set the release version. `__version__` in `numpy_financial/__init__.py`.
 
@@ -68,9 +77,13 @@ PyPI trusted publishing. Do not build or upload artifacts by hand.
 
       - go to https://github.com/numpy/numpy-financial/releases/new?tag=v${VERSION}
       - add v${VERSION} for the `Release title`
-      - paste the ${VERSION} section of ${NOTES} in the `Describe this release section`
+      - paste the contents of ${CHANGES} in the `Describe this release section`
       - if pre-release check the box labelled `Set as a pre-release`
 
+- Delete the scratch file:
+
+      rm ${CHANGES}
+
 - Update https://github.com/numpy/numpy-financial/milestones:
 
       - close old milestone
diff --git a/doc/source/dev/index.rst b/doc/source/dev/index.rst
index 6fbac86..bfd13c9 100644
--- a/doc/source/dev/index.rst
+++ b/doc/source/dev/index.rst
@@ -11,4 +11,8 @@ Development
    checking_out_an_upstream_pr.md
 
 
-.. include:: ../_includes/release-notes.rst
+Release Notes
+-------------
+
+.. include:: ../../../CHANGELOG.md
+   :parser: myst_parser.sphinx_
diff --git a/pyproject.toml b/pyproject.toml
index 22d6b33..5ad137a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -118,6 +118,7 @@ skip = "*-musllinux* *_i686 *-win32"
 test-command = "python -c \"import numpy_financial\""
 
 [tool.changelist]
+title_template = "{version}"
 ignored_user_logins = ["dependabot[bot]", "pre-commit-ci[bot]"]
 
 [tool.ruff.lint]