From b3b16490f7eafea7fe268f4fc1a86593e49e10a1 Mon Sep 17 00:00:00 2001
From: Richard van der Hoff <richard@matrix.org>
Date: Wed, 6 Jun 2018 07:08:36 +0100
Subject: [PATCH] Add note to changelog on prometheus metrics

---
 CHANGES.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/CHANGES.rst b/CHANGES.rst
index 531d9ed15..be9429f4e 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -1,7 +1,10 @@
 Changes in synapse v0.31.0-rc1 (2018-06-04)
 ==========================================
 
-Most notable change is to switch to python prometheus library to improve system stats reporting
+Most notable change is to switch to python prometheus library to improve system
+stats reporting. WARNING this changes a number of prometheus metrics in a
+backwards-incompatible manner. For more details, see
+`docs/metrics-howto.rst <docs/metrics-howto.rst#removal-of-deprecated-metrics--time-based-counters-becoming-histograms-in-0310>`_.
 
 Features: