diff --git a/api/client-server/list_public_rooms.yaml b/api/client-server/list_public_rooms.yaml
index 2072f92a..d5826d69 100644
--- a/api/client-server/list_public_rooms.yaml
+++ b/api/client-server/list_public_rooms.yaml
@@ -123,7 +123,8 @@ paths:
               total_room_count_estimate:
                 type: number
                 description: |-
-                   An estimate on the total number of public rooms.
+                   An estimate on the total number of public rooms, if the
+                   server has an estimate.
           examples:
             application/json: |-
               {
@@ -264,7 +265,8 @@ paths:
               total_room_count_estimate:
                 type: number
                 description: |-
-                   An estimate on the total number of public rooms.
+                   An estimate on the total number of public rooms, if the
+                   server has an estimate.
           examples:
             application/json: |-
               {