diff --git a/PendingReleaseNotes b/PendingReleaseNotes
index ea225a6c0dd..ea46757fcd0 100644
--- a/PendingReleaseNotes
+++ b/PendingReleaseNotes
@@ -273,3 +273,13 @@
   named 'Records'. Note that this does not affect pulling bucket notification
   from a subscription in a 'pubsub' zone, as these are already wrapped inside
   that array.
+
+* The configuration value ``osd_calc_pg_upmaps_max_stddev`` used for upmap
+  balancing has been removed. Instead use the mgr balancer config
+  ``upmap_max_deviation`` which now is an integer number of PGs of deviation
+  from the target PGs per OSD.  This can be set with a command like
+  ``ceph config set mgr mgr/balancer/upmap_max_deviation 2``.  The default
+  ``upmap_max_deviation`` is 1.  There are situations where crush rules
+  would not allow a pool to ever have completely balanced PGs.  For example, if
+  crush requires 1 replica on each of 3 racks, but there are fewer OSDs in 1 of
+  the racks.  In those cases, the configuration value can be increased.