diff --git a/api/client-server/registration.yaml b/api/client-server/registration.yaml
index ecc7a6fa..c3f544c1 100644
--- a/api/client-server/registration.yaml
+++ b/api/client-server/registration.yaml
@@ -345,7 +345,8 @@ paths:
               logout_devices:
                 type: boolean
                 description: |-
-                  Whether other access tokens should be revoked if the request succeeds. Defaults to true.
+                  Whether the other access tokens, and their associated devices, for the user should be 
+                  revoked if the request succeeds. Defaults to true.
                 example: true
               auth:
                 description: |-
diff --git a/changelogs/client_server/newsfragments/2523.feature b/changelogs/client_server/newsfragments/2523.feature
index 6f690ea4..e45d1c2f 100644
--- a/changelogs/client_server/newsfragments/2523.feature
+++ b/changelogs/client_server/newsfragments/2523.feature
@@ -1 +1 @@
-Optionally invalidate other access tokens during password modification per `MSC 2457 <https://github.com/matrix-org/matrix-doc/pull/2457>`_.
+Optionally invalidate other access tokens during password modification per `MSC2457 <https://github.com/matrix-org/matrix-doc/pull/2457>`_.