diff --git a/introspection/nm-secret-agent.xml b/introspection/nm-secret-agent.xml
index 9655c2b9df..daf287c623 100644
--- a/introspection/nm-secret-agent.xml
+++ b/introspection/nm-secret-agent.xml
@@ -38,9 +38,11 @@
             <arg name="hints" type="as" direction="in">
                 <tp:docstring>
                     Array of strings of key names in the requested setting for
-                    which NetworkManager thinks a secrets may be required.  The
-                    Agent should return any secrets it has, or that it thinks
-                    are required, regardless of what hints NetworkManager sends
+                    which NetworkManager thinks a secrets may be required,
+                    and/or well-known identifiers and data that may be useful
+                    to the client in processing the secrets request. The Agent
+                    should return any secrets it has, or that it thinks are
+                    required, regardless of what hints NetworkManager sends
                     in this request.
                 </tp:docstring>
             </arg>