diff --git a/CHANGELOG_PENDING.md b/CHANGELOG_PENDING.md
index bedd771e..35a395d5 100644
--- a/CHANGELOG_PENDING.md
+++ b/CHANGELOG_PENDING.md
@@ -5,14 +5,14 @@ Special thanks to external contributors with PRs included in this release:
 BREAKING CHANGES:
 
 * CLI/RPC/Config
+  * [rpc] [\#2391](https://github.com/tendermint/tendermint/issues/2391) /status `result.node_info.other` became a map
 
 * Apps
-  [rpc] /status `result.node_info.other` became a map #[2391](https://github.com/tendermint/tendermint/issues/2391)
+  * [mempool] \#2310 Mempool tracks the `ResponseCheckTx.GasWanted` and enforces `ConsensusParams.BlockSize.MaxGas` on proposals.
 
 * Go API
-  * \#2310 Mempool.ReapMaxBytes -> Mempool.ReapMaxBytesMaxGas
-  * \#2431 Remove Word256 code in libs/common, due to lack of use
-  * \#2452 Remove the following methods from libs/common due to lack of use:
+  * [libs/common] \#2431 Remove Word256 due to lack of use
+  * [libs/common] \#2452 Remove the following functions due to lack of use:
     * byteslice.go: cmn.IsZeros, cmn.RightPadBytes, cmn.LeftPadBytes, cmn.PrefixEndBytes
     * strings.go: cmn.IsHex, cmn.StripHex
     * int.go: Uint64Slice, all put/get int64 methods
@@ -23,13 +23,13 @@ BREAKING CHANGES:
 
 
 FEATURES:
-  * \#2310 Mempool is now aware of the MaxGas requirement
 
 IMPROVEMENTS:
 - [libs/db] \#2371 Output error instead of panic when the given db_backend is not initialised (@bradyjoestar)
 - [mempool] [\#2399](https://github.com/tendermint/tendermint/issues/2399) Make mempool cache a proper LRU (@bradyjoestar)
-- [types] add Address to GenesisValidator [\#1714](https://github.com/tendermint/tendermint/issues/1714)
+- [types] [\#1714](https://github.com/tendermint/tendermint/issues/1714) Add Address to GenesisValidator
 - [metrics] `consensus.block_interval_metrics` is now gauge, not histogram (you will be able to see spikes, if any)
+- [p2p] \#2126 Introduce PeerTransport interface to improve isolation of concerns
 
 BUG FIXES:
 - [node] \#2294 Delay starting node until Genesis time
diff --git a/README.md b/README.md
index d9704200..2e4146f4 100644
--- a/README.md
+++ b/README.md
@@ -22,7 +22,10 @@ develop   | [![CircleCI](https://circleci.com/gh/tendermint/tendermint/tree/deve
 Tendermint Core is Byzantine Fault Tolerant (BFT) middleware that takes a state transition machine - written in any programming language -
 and securely replicates it on many machines.
 
-For protocol details, see [the specification](/docs/spec). For a consensus proof and detailed protocol analysis checkout our recent paper, "[The latest gossip on BFT consensus](https://arxiv.org/abs/1807.04938)".
+For protocol details, see [the specification](/docs/spec).
+
+For detailed analysis of the consensus protocol, including safety and liveness proofs,
+see our recent paper, "[The latest gossip on BFT consensus](https://arxiv.org/abs/1807.04938)".
 
 ## A Note on Production Readiness
 
@@ -115,6 +118,11 @@ CHANGELOG even if they don't lead to MINOR version bumps:
 - rpc/client
 - config
 - node
+- libs/bech32
+- libs/common
+- libs/db
+- libs/errors
+- libs/log
 
 Exported objects in these packages that are not covered by the versioning scheme
 are explicitly marked by `// UNSTABLE` in their go doc comment and may change at any