diff --git a/public/swagger/swagger-who.yaml b/public/swagger/swagger-who.yaml
index 89d70cd..ea6f760 100644
--- a/public/swagger/swagger-who.yaml
+++ b/public/swagger/swagger-who.yaml
@@ -56,7 +56,7 @@ paths:
     - $ref: "#/components/parameters/id"
     - $ref: "#/components/parameters/namespace"
     requestBody:
-      description: "An entity where all fields are optional and modified is disallowed"
+      description: "An entity where all fields are optional and modified is disallowed. Modifying sub-documents is possible via dot notation."
       content:
         $ref: "#/components/schemas/oneContent"
     responses: