diff --git a/doc/src/sgml/release-10.sgml b/doc/src/sgml/release-10.sgml
index 93bcb079be2..18483238f10 100644
--- a/doc/src/sgml/release-10.sgml
+++ b/doc/src/sgml/release-10.sgml
@@ -49,26 +49,14 @@
-Improve hash bucket split performance by reducing locking requirements
-(Amit Kapila, Mithun Cy)
+pg_upgrade>-ed hash indexes from previous major Postgres versions must be rebuilt.
-Also cache hash index meta-information for faster lookups. Additional
-hash performance improvements have also been made. pg_upgrade>'d hash
-indexes from previous major Postgres versions must be rebuilt.
+Major hash index performance improvements necessitated this requirement.
@@ -475,6 +463,30 @@ warning message about their use.
+
+
+
+Improve hash bucket split performance by reducing locking requirements
+(Amit Kapila, Mithun Cy)
+
+
+
+Also cache hash index meta-information for faster lookups. Additional
+hash performance improvements have also been made.
+
+
+