diff --git a/docs/changes.rst b/docs/changes.rst
index 2a8ed4098..fea8bfd2f 100644
--- a/docs/changes.rst
+++ b/docs/changes.rst
@@ -1,6 +1,21 @@
 Changelog
 =========
 
+Version 0.28.1
+--------------
+
+Bug fixes:
+
+- do not try to build api / usage docs for production install,
+  fixes unexpected "mock" build dependency, #384
+
+Other changes:
+
+- avoid using msgpack.packb at import time
+- fix formatting issue in changes.rst
+- fix build on readthedocs
+
+
 Version 0.28.0
 --------------