Prefer passive voice

SAP · Feb 14, 2025 · 9a5fe54 · 9a5fe54
1 parent 256632f
commit 9a5fe54
Show file tree

Hide file tree

Showing 3 changed files with 5 additions and 5 deletions.
diff --git a/vocabularies/Hierarchy.json b/vocabularies/Hierarchy.json
@@ -224,7 +224,7 @@
         "$IsBound": true,
         "@Common.Experimental": true,
         "@Core.Description": "Template for actions that copy a node and its descendants and are named in [`RecursiveHierarchyActions/CopyAction`](#RecursiveHierarchyActionsType)",
-        "@Core.LongDescription": "The action copies a node A and its descendants and the parent navigation properties between them\nso that the copied nodes form a sub-hierarchy. It returns the copy of A. No assumption is made about the parent of the copy of A.\n\nTo specify the parent of the copy of A, the action invocation MUST be followed\nby a PATCH that binds its parent navigation property (for example, `Superordinate` in the following JSON batch request)\nto the desired parent B or to `null`.\n```json\n{\"requests\": [{\n  \"id\": \"1\",\n  \"method\": \"post\",\n  \"url\": \"HierarchyDirectory(1)/Nodes('A')/CopyAction\"\n}, {\n  \"id\": \"2\",\n  \"dependsOn\": [\"1\"],\n  \"method\": \"patch\",\n  \"url\": \"$1\",\n  \"body\": {\n    \"[email protected]\": \"Nodes('B')\"\n  }\n}]}\n```\nTo position the copy of A among its new siblings, additionally include an invocation of\n[`ChangeNextSiblingAction`](#Template_ChangeNextSiblingAction) in the batch request.",
+        "@Core.LongDescription": "The action copies a node A and its descendants and the parent navigation properties between them\nso that the copied nodes form a sub-hierarchy. It returns the copy of A. No assumption is made about the parent of the copy of A.\n\nTo specify the parent of the copy of A, the action invocation MUST be followed\nby a PATCH that binds its parent navigation property (for example, `Superordinate` in the following JSON batch request)\nto the desired parent B or to `null`.\n```json\n{\"requests\": [{\n  \"id\": \"1\",\n  \"method\": \"post\",\n  \"url\": \"HierarchyDirectory(1)/Nodes('A')/CopyAction\"\n}, {\n  \"id\": \"2\",\n  \"dependsOn\": [\"1\"],\n  \"method\": \"patch\",\n  \"url\": \"$1\",\n  \"body\": {\n    \"[email protected]\": \"Nodes('B')\"\n  }\n}]}\n```\nIf a certain position of the copy of A among its new siblings is desired, an additional invocation of\n[`ChangeNextSiblingAction`](#Template_ChangeNextSiblingAction) can be included in the batch request.",
         "$Parameter": [{ "$Name": "Node", "$Type": "Edm.EntityType", "@Core.Description": "The node to be copied" }],
         "$ReturnType": { "$Type": "Edm.EntityType", "@Core.Description": "The copied node" }
       }

diff --git a/vocabularies/Hierarchy.md b/vocabularies/Hierarchy.md
@@ -53,8 +53,8 @@ to the desired parent B or to `null`.
   }
 }]}
 ```
-To position the copy of A among its new siblings, additionally include an invocation of
-[`ChangeNextSiblingAction`](#Template_ChangeNextSiblingAction) in the batch request.
+If a certain position of the copy of A among its new siblings is desired, an additional invocation of
+[`ChangeNextSiblingAction`](#Template_ChangeNextSiblingAction) can be included in the batch request.
 
 Parameter|Type|Description
 :--------|:---|:----------

diff --git a/vocabularies/Hierarchy.xml b/vocabularies/Hierarchy.xml
@@ -359,8 +359,8 @@ to the desired parent B or to `null`.
   }
 }]}
 ```
-To position the copy of A among its new siblings, additionally include an invocation of
-[`ChangeNextSiblingAction`](#Template_ChangeNextSiblingAction) in the batch request.</String>
+If a certain position of the copy of A among its new siblings is desired, an additional invocation of
+[`ChangeNextSiblingAction`](#Template_ChangeNextSiblingAction) can be included in the batch request.</String>
         </Annotation>
         <Parameter Name="Node" Type="Edm.EntityType" Nullable="false">
           <Annotation Term="Core.Description" String="The node to be copied" />