update changelog and upgrading

CHANGELOG_PENDING.md

@@ -1,14 +1,25 @@
 # Pending
 
-Special thanks to external contributors with PRs included in this release:
+Special thanks to external contributors on this release:
+@scriptionist, @bradyjoestar, @WALL-E
+
+This release is mostly about the ConsensusParams - removing fields and enforcing MaxGas.
+It also addresses some issues found via security audit, removes various unused
+functions from `libs/common`, and implements
+[ADR-012](https://github.com/tendermint/tendermint/blob/develop/docs/architecture/adr-012-peer-transport.md).
+
+Friendly reminder, we have a [bug bounty program](https://hackerone.com/tendermint).
 
 BREAKING CHANGES:
 
 * CLI/RPC/Config
   * [rpc] [\#2391](https://github.com/tendermint/tendermint/issues/2391) /status `result.node_info.other` became a map
+  * [types] \#2364 Remove `TxSize` and `BlockGossip` from `ConsensusParams`
+    * Maximum tx size is now set implicitly via the `BlockSize.MaxBytes`
+    * The size of block parts in the consensus is now fixed to 64kB
 
 * Apps
-  * [mempool] \#2310 Mempool tracks the `ResponseCheckTx.GasWanted` and enforces `ConsensusParams.BlockSize.MaxGas` on proposals.
+  * [mempool] \#2360 Mempool tracks the `ResponseCheckTx.GasWanted` and enforces `ConsensusParams.BlockSize.MaxGas` on proposals.
 
 * Go API
   * [libs/common] \#2431 Remove Word256 due to lack of use
@@ -17,21 +28,23 @@ BREAKING CHANGES:
     * strings.go: cmn.IsHex, cmn.StripHex
     * int.go: Uint64Slice, all put/get int64 methods
 
-* Blockchain Protocol
-
-* P2P Protocol
-
-
 FEATURES:
+- [rpc] \#2415 New `/consensus_params?height=X` endpoint to query the consensus
+  params at any height (@scriptonist)
+- [types] [\#1714](https://github.com/tendermint/tendermint/issues/1714) Add Address to GenesisValidator
+- [metrics] \#2337 `consensus.block_interval_metrics` is now gauge, not histogram (you will be able to see spikes, if any)
 
 IMPROVEMENTS:
-- [libs/db] \#2371 Output error instead of panic when the given db_backend is not initialised (@bradyjoestar)
+- [libs/db] \#2371 Output error instead of panic when the given `db_backend` is not initialised (@bradyjoestar)
+- [libs] \#2286 Enforce 0600 permissions on `autofile` and `db/fsdb`
+
 - [mempool] [\#2399](https://github.com/tendermint/tendermint/issues/2399) Make mempool cache a proper LRU (@bradyjoestar)
-- [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
+- [libs/common] \#2326 Service returns ErrNotStarted
 
 BUG FIXES:
 - [node] \#2294 Delay starting node until Genesis time
 - [consensus] \#2048 Correct peer statistics for marking peer as good
-- [rpc] \#2460 StartHTTPAndTLSServer() now passes StartTLS() errors back to the caller rather than hanging forever.
+- [rpc] \#2460 StartHTTPAndTLSServer() now passes StartTLS() errors back to the caller rather than hanging forever.
+- [p2p] \#2047 Accept new connections asynchronously
+- [tm-bench] \#2410 Enforce minimum transaction size (@WALL-E)

UPGRADING.md

@@ -3,6 +3,12 @@
 This guide provides steps to be followed when you upgrade your applications to
 a newer version of Tendermint Core.
 
+## v0.25.0
+
+This release has minimal impact.
+
+If you use GasWanted in ABCI and want to enforce it, set the MaxGas in the genesis file (default is no max).
+
 ## v0.24.0
 
 New 0.24.0 release contains a lot of changes to the state and types. It's not