admin-shell-io#445: Editorial - shortened and grammar

Author: alexgordtop

documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc

@@ -71,7 +71,7 @@ e|payload a|Requested Asset Administration Shell |yes | link:https://industriald
 [width=100%,cols="25%,35%,10%,20%,10%"]
 |===
 h|*Operation Name* 4+e|[[PutAssetAdministrationShell]]PutAssetAdministrationShell
-h|Explanation 4+a|Replaces the Asset Administration Shell or create it if it does not exist
+h|Explanation 4+a|Creates or replaces the Asset Administration Shell
 h|*semanticId* 4+|`\https://admin-shell.io/aas/API/PutAssetAdministrationShell/3/0`
 
 h|Name h|*Description* h|*Mand.* h|*Type* h|*Card.*
@@ -357,7 +357,7 @@ h|Name h|Description h|Mand. h|Type h|Card.
 [width=100%,cols="25%,35%,10%,20%,10%"]
 |===
 h|Operation Name 4+e|[[PutSubmodel]]PutSubmodel
-h|Explanation 4+a|Replaces the Submodel or creates it if it does not exist
+h|Explanation 4+a|Creates or replaces the Submodel
 h|semanticId 4+|`\https://admin-shell.io/aas/API/PutSubmodel/3/0`
 
 h|Name h|Description h|Mand. h|Type h|Card.
@@ -826,7 +826,7 @@ h|Operation Name h|Description
 |xref:GetAssetAdministrationShellDescriptorById[GetAssetAdministrationShellDescriptorById] a|Returns a specific Asset Administration Shell Descriptor
 |xref:PostAssetAdministrationShellDescriptor[PostAssetAdministrationShellDescriptor] a|Creates a new Asset Administration Shell Descriptor, i.e., registers an AAS
 |xref:CreateBulkAssetAdministrationShellDescriptors[CreateBulkAssetAdministrationShellDescriptors] a| Creates multiple new Asset Administration Shell Descriptors, i.e., registers multiple Asset Administration Shells
-|xref:PutAssetAdministrationShellDescriptorById[PutAssetAdministrationShellDescriptorById] a|Replaces an existing Asset Administration Shell Descriptor, i.e., replaces registration information or creates it if it does not exist
+|xref:PutAssetAdministrationShellDescriptorById[PutAssetAdministrationShellDescriptorById] a|Creates or replaces an existing Asset Administration Shell Descriptor, i.e., replaces registration information
 |xref:PutBulkAssetAdministrationShellDescriptorsById[PutBulkAssetAdministrationShellDescriptorsById] a| Creates or updates multiple existing Asset Administration Shell Descriptors
 |xref:DeleteAssetAdministrationShellDescriptorById[DeleteAssetAdministrationShellDescriptorById] a|Deletes an Asset Administration Shell Descriptor, i.e., de-registers an AAS
 |xref:DeleteBulkAssetAdministrationShellDescriptorsById[DeleteBulkAssetAdministrationShellDescriptorsById] a| Deletes multiple Asset Administration Shell Descriptors, i.e., de-registers multiple Asset Administration Shells
@@ -909,7 +909,7 @@ h|Name h|Description h|Mand. h|Type h|Card.
 [width=100%,cols="25%,35%,10%,20%,10%"]
 |===
 h|Operation Name 4+e|[[PutAssetAdministrationShellDescriptorById]]PutAssetAdministrationShellDescriptorById
-h|Explanation 4+a|Replaces an existing Asset Administration Shell Descriptor, i.e., replaces registration information or creates it if it does not exist
+h|Explanation 4+a|Creates or replaces an existing Asset Administration Shell Descriptor, i.e., replaces registration information
 h|semanticId 4+|`\https://admin-shell.io/aas/API/PutAssetAdministrationShellDescriptorById/3/1`
 
 h|Name h|Description h|Mand. h|Type h|Card.