From 684e3cb4460f33c89cdd71a00a3ea588bb20aebb Mon Sep 17 00:00:00 2001
From: Anton Kaliaev <anton.kalyaev@gmail.com>
Date: Wed, 15 Aug 2018 12:53:00 +0400
Subject: [PATCH] add upgrading guides

---
 UPGRADING.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 UPGRADING.md

diff --git a/UPGRADING.md b/UPGRADING.md
new file mode 100644
index 000000000..a290d57d7
--- /dev/null
+++ b/UPGRADING.md
@@ -0,0 +1,32 @@
+# Upgrading Tendermint Core
+
+This guide provides steps to be followed when you upgrade your applications to
+a newer version of Tendermint Core.
+
+## Upgrading from 0.23.0 to 0.24.0
+
+New 0.24.0 release contains a lot of changes to the state and types. It's not
+compatible to the old versions.
+
+To reset the state do:
+
+```
+$ tendermint unsafe_reset_all
+```
+
+### Config changes
+
+`p2p.max_num_peers` was removed in favor of `p2p.max_num_inbound_peers` and
+`p2p.max_num_outbound_peers`. 
+
+```
+# Maximum number of inbound peers
+max_num_inbound_peers = 40
+
+# Maximum number of outbound peers to connect to, excluding persistent peers
+max_num_outbound_peers = 10
+```
+
+As you can see, the default ratio of inbound/outbound peers is 4/1. The reason
+as we want it to be easier for new nodes to connect to the network. You can
+tweak these parameters to alter the network topology.