diff --git a/UPGRADING.md b/UPGRADING.md
index dcf16d598..2ab17fb06 100644
--- a/UPGRADING.md
+++ b/UPGRADING.md
@@ -7,6 +7,10 @@ a newer version of Tendermint Core.
 
 <Overview>
 
+### Go API
+
+- `rpc/client` HTTP and local clients have been moved into `http` and `local` subpackages, and their constructors have been renamed to `New()`.
+
 ### Protobuf Changes
 
 When upgrading to version <version #> you will have to fetch the `third_party` directory along with the updated proto files.