diff --git a/README.rst b/README.rst
index 8e16300984d9af785d6aaaf0b1123258578e98e9..1eb40b5921fd63956aac78bd714bd7d74b5cef50 100644
--- a/README.rst
+++ b/README.rst
@@ -37,3 +37,14 @@ Features
 * Secret-key encryption
 * Public-key encryption
 * HMAC (coming soon)
+
+
+Changes
+-------
+
+* 0.3.0: the low-level API (`nacl.c.*`) has been changed to match the
+  upstream NaCl C/C++ conventions (as well as those of other NaCl bindings).
+  The order of arguments and return values has changed significantly. If you
+  have code which calls these functions (e.g. `nacl.c.crypto_box_keypair()`),
+  you must review the new docstrings and update your code to match the new
+  conventions.