diff --git a/docs/release.rst b/docs/release.rst
index 1e2f976b..944c6e97 100644
--- a/docs/release.rst
+++ b/docs/release.rst
@@ -1,6 +1,11 @@
 Release notes
 =============
 
+* Changed :func:`allel.util.hdf5_cache` to resolve issues with hashing and
+  argument order
+  (`#51 <https://github.com/cggh/scikit-allel/issues/51>`_,
+   `#52 <https://github.com/cggh/scikit-allel/issues/52>`_).
+
 v0.20.1
 -------