diff --git a/CHANGELOG.rst b/CHANGELOG.rst
index 25d2d0349..05f21a2c4 100644
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@@ -10,7 +10,10 @@ Unreleased
 1.10.0 - 2024-01-12
 -------------------
 
-* Add two new convenicence properties to ``XBlock`` objects: ``.usage_key`` and ``.context_key``.
+* Add two new properties to ``XBlock`` objects: ``.usage_key`` and ``.context_key``.
+  These simply expose the values of ``.scope_ids.usage_id`` and ``.scope_ids.usage_id.context_key``,
+  providing a convenient replacement to the deprecated, edx-platform-specific block properties ``.location``
+  and ``.course_id``, respectively.
 
 1.9.1 - 2023-12-22
 ------------------