diff --git a/doc/design-monitoring-agent.rst b/doc/design-monitoring-agent.rst
index e21f3321bec083df457914b53f2bee211b1065d2..49803b4d09ed2d772edf397f34e4269e66fe7e07 100644
--- a/doc/design-monitoring-agent.rst
+++ b/doc/design-monitoring-agent.rst
@@ -246,7 +246,8 @@ upon.
 
 The instance status will be on each node, for the instances it is
 primary for, and its ``data`` section of the report will contain a list
-of instances, with at least the following fields for each instance:
+of instances, named ``instances``, with at least the following fields for
+each instance:
 
 ``name``
   The name of the instance.
@@ -269,8 +270,8 @@ of instances, with at least the following fields for each instance:
 
 ``state_reason``
   The last known reason for state change of the instance, described according
-  to the JSON representation of a reason trail, as detailed in the :doc:`reason trail
-  design document <design-reason-trail>`.
+  to the JSON representation of a reason trail, as detailed in the :doc:`reason
+  trail design document <design-reason-trail>`.
 
 ``status``
   It represents the status of the instance, and its format is the same as that