diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..defd28d
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,17 @@
+
+# Changelog
+All notable changes to rattail-fabric2 will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+## v0.4.0 (2024-06-10)
+
+### Feat
+
+- switch from setup.cfg to pyproject.toml + hatchling
+
+
+## Older Releases
+
+Please see `docs/OLDCHANGES.rst` for older release notes.
diff --git a/CHANGES.rst b/docs/OLDCHANGES.rst
similarity index 93%
rename from CHANGES.rst
rename to docs/OLDCHANGES.rst
index c54c290..da50b54 100644
--- a/CHANGES.rst
+++ b/docs/OLDCHANGES.rst
@@ -2,8 +2,9 @@
 CHANGELOG
 =========
 
-Unreleased
-----------
+NB. this file contains "old" release notes only.  for newer releases
+see the `CHANGELOG.md` file in the source root folder.
+
 
 0.3.6 (2024-05-31)
 ------------------
diff --git a/pyproject.toml b/pyproject.toml
index 8ef1111..f9d9272 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rattail-fabric2"
-version = "0.3.6"
+version = "0.4.0"
 description = "Fabric (v2) Utilities for Rattail"
 readme = "README.rst"
 authors = [{name = "Lance Edgar", email = "lance@edbob.org"}]
@@ -33,7 +33,7 @@ dependencies = [
 [project.urls]
 Homepage = "https://rattailproject.org"
 Repository = "https://kallithea.rattailproject.org/rattail-project/rattail-fabric2"
-Changelog = "https://kallithea.rattailproject.org/rattail-project/rattail-fabric2/files/master/CHANGES.rst"
+Changelog = "https://kallithea.rattailproject.org/rattail-project/rattail-fabric2/files/master/CHANGELOG.md"
 
 
 [tool.commitizen]