From 25a95371d119166122870f88024034f8e983a320 Mon Sep 17 00:00:00 2001
From: Ralf Handl <ralf.handl@sap.com>
Date: Thu, 15 Feb 2024 11:51:31 +0100
Subject: [PATCH 1/2] ODATA-1214

---
 vocabularies/Org.OData.Core.V1.json | 9 +++++++++
 vocabularies/Org.OData.Core.V1.md   | 1 +
 vocabularies/Org.OData.Core.V1.xml  | 4 ++++
 3 files changed, 14 insertions(+)

diff --git a/vocabularies/Org.OData.Core.V1.json b/vocabularies/Org.OData.Core.V1.json
index 2d000672..5516b73d 100644
--- a/vocabularies/Org.OData.Core.V1.json
+++ b/vocabularies/Org.OData.Core.V1.json
@@ -737,6 +737,15 @@
             ],
             "@Core.Description": "Instances of a type are annotated with this tag if they have no common structure in a given response payload",
             "@Core.LongDescription": "The select-list of a context URL MUST be `(@Core.AnyStructure)` if it would otherwise be empty,\n          but this instance annotation SHOULD be omitted from the response value."
+        },
+        "Constructor": {
+            "$Kind": "Term",
+            "$Type": "Core.Tag",
+            "$DefaultValue": true,
+            "$AppliesTo": [
+                "Action"
+            ],
+            "@Core.Description": "The annotated action creates new entities"
         }
     }
 }
\ No newline at end of file
diff --git a/vocabularies/Org.OData.Core.V1.md b/vocabularies/Org.OData.Core.V1.md
index f9fc51b5..f5c67203 100644
--- a/vocabularies/Org.OData.Core.V1.md
+++ b/vocabularies/Org.OData.Core.V1.md
@@ -51,6 +51,7 @@ Term|Type|Description
 [SymbolicName](./Org.OData.Core.V1.xml#L536:~:text=<Term%20Name="-,SymbolicName,-")|[SimpleIdentifier](#SimpleIdentifier)|<a name="SymbolicName"></a>A symbolic name for a model element
 [GeometryFeature](./Org.OData.Core.V1.xml#L545:~:text=<Term%20Name="-,GeometryFeature,-")|[GeometryFeatureType?](#GeometryFeatureType)|<a name="GeometryFeature"></a>A [Feature Object](https://datatracker.ietf.org/doc/html/rfc7946#section-3.2) represents a spatially bounded thing
 [AnyStructure](./Org.OData.Core.V1.xml#L561:~:text=<Term%20Name="-,AnyStructure,-")|[Tag](#Tag)|<a name="AnyStructure"></a>Instances of a type are annotated with this tag if they have no common structure in a given response payload<br>The select-list of a context URL MUST be `(@Core.AnyStructure)` if it would otherwise be empty, but this instance annotation SHOULD be omitted from the response value.
+[Constructor](./Org.OData.Core.V1.xml#L569:~:text=<Term%20Name="-,Constructor,-")|[Tag](#Tag)|<a name="Constructor"></a>The annotated action creates new entities
 
 <a name="RevisionType"></a>
 ## [RevisionType](./Org.OData.Core.V1.xml#L80:~:text=<ComplexType%20Name="-,RevisionType,-")
diff --git a/vocabularies/Org.OData.Core.V1.xml b/vocabularies/Org.OData.Core.V1.xml
index 601a6e78..4aa35b1e 100644
--- a/vocabularies/Org.OData.Core.V1.xml
+++ b/vocabularies/Org.OData.Core.V1.xml
@@ -566,6 +566,10 @@ Any simple identifier | Any type listed in `Validation.OpenPropertyTypeConstrain
         </Annotation>
       </Term>
 
+      <Term Name="Constructor" Type="Core.Tag" Nullable="false" DefaultValue="true" AppliesTo="Action">
+        <Annotation Term="Core.Description" String="The annotated action creates new entities" />
+      </Term>
+
     </Schema>
   </edmx:DataServices>
 </edmx:Edmx>

From 955c00e5f739fcd28bb98b96905a91565e0c0050 Mon Sep 17 00:00:00 2001
From: Ralf Handl <ralf.handl@sap.com>
Date: Thu, 15 Feb 2024 11:56:32 +0100
Subject: [PATCH 2/2] Rephrased

---
 vocabularies/Org.OData.Core.V1.json | 2 +-
 vocabularies/Org.OData.Core.V1.md   | 2 +-
 vocabularies/Org.OData.Core.V1.xml  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/vocabularies/Org.OData.Core.V1.json b/vocabularies/Org.OData.Core.V1.json
index 5516b73d..81618dbf 100644
--- a/vocabularies/Org.OData.Core.V1.json
+++ b/vocabularies/Org.OData.Core.V1.json
@@ -745,7 +745,7 @@
             "$AppliesTo": [
                 "Action"
             ],
-            "@Core.Description": "The annotated action creates new entities"
+            "@Core.Description": "On success the annotated action creates a new entity"
         }
     }
 }
\ No newline at end of file
diff --git a/vocabularies/Org.OData.Core.V1.md b/vocabularies/Org.OData.Core.V1.md
index f5c67203..d04980f9 100644
--- a/vocabularies/Org.OData.Core.V1.md
+++ b/vocabularies/Org.OData.Core.V1.md
@@ -51,7 +51,7 @@ Term|Type|Description
 [SymbolicName](./Org.OData.Core.V1.xml#L536:~:text=<Term%20Name="-,SymbolicName,-")|[SimpleIdentifier](#SimpleIdentifier)|<a name="SymbolicName"></a>A symbolic name for a model element
 [GeometryFeature](./Org.OData.Core.V1.xml#L545:~:text=<Term%20Name="-,GeometryFeature,-")|[GeometryFeatureType?](#GeometryFeatureType)|<a name="GeometryFeature"></a>A [Feature Object](https://datatracker.ietf.org/doc/html/rfc7946#section-3.2) represents a spatially bounded thing
 [AnyStructure](./Org.OData.Core.V1.xml#L561:~:text=<Term%20Name="-,AnyStructure,-")|[Tag](#Tag)|<a name="AnyStructure"></a>Instances of a type are annotated with this tag if they have no common structure in a given response payload<br>The select-list of a context URL MUST be `(@Core.AnyStructure)` if it would otherwise be empty, but this instance annotation SHOULD be omitted from the response value.
-[Constructor](./Org.OData.Core.V1.xml#L569:~:text=<Term%20Name="-,Constructor,-")|[Tag](#Tag)|<a name="Constructor"></a>The annotated action creates new entities
+[Constructor](./Org.OData.Core.V1.xml#L569:~:text=<Term%20Name="-,Constructor,-")|[Tag](#Tag)|<a name="Constructor"></a>On success the annotated action creates a new entity
 
 <a name="RevisionType"></a>
 ## [RevisionType](./Org.OData.Core.V1.xml#L80:~:text=<ComplexType%20Name="-,RevisionType,-")
diff --git a/vocabularies/Org.OData.Core.V1.xml b/vocabularies/Org.OData.Core.V1.xml
index 4aa35b1e..06208a66 100644
--- a/vocabularies/Org.OData.Core.V1.xml
+++ b/vocabularies/Org.OData.Core.V1.xml
@@ -567,7 +567,7 @@ Any simple identifier | Any type listed in `Validation.OpenPropertyTypeConstrain
       </Term>
 
       <Term Name="Constructor" Type="Core.Tag" Nullable="false" DefaultValue="true" AppliesTo="Action">
-        <Annotation Term="Core.Description" String="The annotated action creates new entities" />
+        <Annotation Term="Core.Description" String="On success the annotated action creates a new entity" />
       </Term>
 
     </Schema>