diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 00000000..a41d6628
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,17 @@
+## 0.9.0 - 2020-04-21
+
+### Added
+
+- [This changelog!](https://github.com/bsdci/libioc/pull/757)
+- [Released as Port](), this means it can now be installed vith `pkg`
+
+### Changed
+
+- update our direct dependencies `py-jail` and `py-freebsd_sysctl`.
+- [changed our installation of development dependencies](https://github.com/bsdci/libioc/pull/756)
+- [speedup loading of C library](https://github.com/bsdci/libioc/pull/752)
+
+### Fixed
+
+- [Fix ZFS mount issue](https://github.com/bsdci/libioc/issues/755) this was a regression in libzfs core
+- [Fix build on FreeBSD 12.1](https://github.com/bsdci/libioc/issues/750)
diff --git a/README.md b/README.md
index 6f227ed2..c9f97ee4 100644
--- a/README.md
+++ b/README.md
@@ -114,6 +114,13 @@ make install-dev
 make check
 ```
 
+### Releases
+
+We try to *manually* keep a [Changelog](CHANGELOG.md), following the style on [changelog.md](https://changelog.md).
+New releases are tagged according to [Semver](https://semver.org/), released on [PyPi](https://pypi.org/project/libioc/), and published as [port](https://github.com/bsdci/ports).
+
+To get a port published, we need to [create a Bugzilla Issue in the Ports category](https://bugs.freebsd.org/bugzilla/enter_bug.cgi?component=Individual%20Port%28s%29&product=Ports%20%26%20Packages)
+
 ---
 
 ### Project Status (Archive)