Renzo's proposal

vocabularies/Common.json

@@ -1221,7 +1221,7 @@
                 "$Type": "Common.QualifiedName",
                 "$Nullable": true,
                 "@Core.Description": "Action that creates a new draft",
-                "@Core.LongDescription": "The action is bound to the draft document root entity set and has the following signature:\n\n            - `ResultIsActiveEntity` of type `Boolean` with default `false`, `true` means that an active entity is created\n\n            New drafts may also be created by POSTing an empty entity without any properties to the entity set."
+                "@Core.LongDescription": "The action is bound to the draft document root entity set and has the following signature:\n\n            - `ResultIsActiveEntity` of type `Boolean` with default `false`, `true` means that an active entity is created\n\n            New drafts may also be created by POSTing an entity with property IsActiveEntity=false (default) to the entity set."
             },
             "AdditionalNewActions": {
                 "$Collection": true,

vocabularies/Common.md

@@ -319,7 +319,7 @@ Property|Type|Description
 [ActivationAction](./Common.xml#L994:~:text=<ComplexType%20Name="-,DraftRootType,-")|[QualifiedName](#QualifiedName)|Action that activates a draft document
 [DiscardAction](./Common.xml#L997:~:text=<ComplexType%20Name="-,DraftRootType,-")|[QualifiedName?](#QualifiedName)|Action that discards a draft document
 [EditAction](./Common.xml#L1000:~:text=<ComplexType%20Name="-,DraftRootType,-")|[QualifiedName?](#QualifiedName)|Action that creates an edit draft<br>The action is bound to the active document root node and has the following signature:<br/> - `PreserveChanges`: optional, of type `Boolean`, `true` means that an outdated draft of another user is not overwritten
-[NewAction](./Common.xml#L1008:~:text=<ComplexType%20Name="-,DraftRootType,-")|[QualifiedName?](#QualifiedName)|Action that creates a new draft<br>The action is bound to the draft document root entity set and has the following signature:<br/> - `ResultIsActiveEntity` of type `Boolean` with default `false`, `true` means that an active entity is created<br/> New drafts may also be created by POSTing an empty entity without any properties to the entity set.
+[NewAction](./Common.xml#L1008:~:text=<ComplexType%20Name="-,DraftRootType,-")|[QualifiedName?](#QualifiedName)|Action that creates a new draft<br>The action is bound to the draft document root entity set and has the following signature:<br/> - `ResultIsActiveEntity` of type `Boolean` with default `false`, `true` means that an active entity is created<br/> New drafts may also be created by POSTing an entity with property IsActiveEntity=false (default) to the entity set.
 [AdditionalNewActions](./Common.xml#L1019:~:text=<ComplexType%20Name="-,DraftRootType,-")|\[[QualifiedName](#QualifiedName)\]|Additional actions beside the default POST or standard `NewAction`that create a new draft<br>The actions are bound to the draft document root entity set and have the following signature:<br/> - `ResultIsActiveEntity` of type `Boolean` with default `false`, `true` means that an active entity is created
 [ShareAction](./Common.xml#L1027:~:text=<ComplexType%20Name="-,DraftRootType,-")|[QualifiedName?](#QualifiedName)|Action that shares a draft document with other users and restricts access to the listed users in their specified roles<br>The action is bound to the draft document root node and has the following signature:<br/> - `Users`: collection of structure with properties<br/>   ◦ `UserID` of type `String`<br/>   ◦ `UserAccessRole` of type `String` with possible values `O` (owner, can perform all draft actions), and `E` (editor, can change the draft)<br/> - `ShareAll` of type `Boolean` with default value `false`, `true` means sharing with all users that are authorized to create drafts; the `Users` parameter is optional in this case, provide it to actively notify the listed users
 

vocabularies/Common.xml

@@ -1013,7 +1013,7 @@ The minimum structure is
 
             - `ResultIsActiveEntity` of type `Boolean` with default `false`, `true` means that an active entity is created
 
-            New drafts may also be created by POSTing an empty entity without any properties to the entity set.</String>
+            New drafts may also be created by POSTing an entity with property IsActiveEntity=false (default) to the entity set.</String>
           </Annotation>
         </Property>
         <Property Name="AdditionalNewActions" Type="Collection(Common.QualifiedName)" Nullable="false">