Simplify endpoint descriptions - remove redundant phrases and fix compound words

Co-authored-by: AndyButland <[email protected]>

Author: Copilot

src/Umbraco.Cms.Api.Management/Controllers/DataType/CreateDataTypeController.cs

@@ -34,7 +34,7 @@ public CreateDataTypeController(IDataTypeService dataTypeService, IDataTypePrese
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
     [EndpointSummary("Creates a new data type.")]
-    [EndpointDescription("Creates a new data type with the configuration specified in the request model.")]
+    [EndpointDescription("Creates a new data type from the request.")]
     public async Task<IActionResult> Create(CancellationToken cancellationToken, CreateDataTypeRequestModel createDataTypeRequestModel)
     {
         var attempt = await _dataTypePresentationFactory.CreateAsync(createDataTypeRequestModel);

src/Umbraco.Cms.Api.Management/Controllers/DataType/Folder/UpdateDataTypeFolderController.cs

@@ -23,7 +23,7 @@ public UpdateDataTypeFolderController(
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
     [EndpointSummary("Updates a datatype folder.")]
-    [EndpointDescription("Updates a datatype folder identified by the provided Id with the details from the request model.")]
+    [EndpointDescription("Updates a datatype folder identified by the provided Id from the request.")]
     public async Task<IActionResult> Update(
         CancellationToken cancellationToken,
         Guid id,

src/Umbraco.Cms.Api.Management/Controllers/DataType/UpdateDataTypeController.cs

@@ -34,7 +34,7 @@ public UpdateDataTypeController(IDataTypeService dataTypeService, IBackOfficeSec
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
     [EndpointSummary("Updates a datatype.")]
-    [EndpointDescription("Updates a datatype identified by the provided Id with the details from the request model.")]
+    [EndpointDescription("Updates a datatype identified by the provided Id from the request.")]
     public async Task<IActionResult> Update(CancellationToken cancellationToken, Guid id, UpdateDataTypeRequestModel updateDataTypeViewModel)
     {
         IDataType? current = await _dataTypeService.GetAsync(id);

src/Umbraco.Cms.Api.Management/Controllers/Dictionary/CreateDictionaryController.cs

@@ -42,7 +42,7 @@ public CreateDictionaryController(
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status409Conflict)]
     [EndpointSummary("Creates a new dictionary.")]
-    [EndpointDescription("Creates a new dictionary with the configuration specified in the request model.")]
+    [EndpointDescription("Creates a new dictionary from the request.")]
     public async Task<IActionResult> Create(
         CancellationToken cancellationToken,
         CreateDictionaryItemRequestModel createDictionaryItemRequestModel)

src/Umbraco.Cms.Api.Management/Controllers/Dictionary/UpdateDictionaryController.cs

@@ -42,7 +42,7 @@ public UpdateDictionaryController(
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
     [EndpointSummary("Updates a dictionary.")]
-    [EndpointDescription("Updates a dictionary identified by the provided Id with the details from the request model.")]
+    [EndpointDescription("Updates a dictionary identified by the provided Id from the request.")]
     public async Task<IActionResult> Update(
         CancellationToken cancellationToken,
         Guid id,

src/Umbraco.Cms.Api.Management/Controllers/Document/CreateDocumentController.cs

@@ -37,7 +37,7 @@ public CreateDocumentController(
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
     [EndpointSummary("Creates a new document.")]
-    [EndpointDescription("Creates a new document with the configuration specified in the request model.")]
+    [EndpointDescription("Creates a new document from the request.")]
     public async Task<IActionResult> Create(
         CancellationToken cancellationToken,
         CreateDocumentRequestModel requestModel)

src/Umbraco.Cms.Api.Management/Controllers/Document/UpdateDocumentController.cs

@@ -37,7 +37,7 @@ public UpdateDocumentController(
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
     [EndpointSummary("Updates a document.")]
-    [EndpointDescription("Updates a document identified by the provided Id with the details from the request model.")]
+    [EndpointDescription("Updates a document identified by the provided Id from the request.")]
     public async Task<IActionResult> Update(
         CancellationToken cancellationToken,
         Guid id,

src/Umbraco.Cms.Api.Management/Controllers/Document/UpdateDomainsController.cs

@@ -33,7 +33,7 @@ public UpdateDomainsController(IDomainService domainService, IUmbracoMapper umbr
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status409Conflict)]
     [EndpointSummary("Updates a document.")]
-    [EndpointDescription("Updates a document identified by the provided Id with the details from the request model.")]
+    [EndpointDescription("Updates a document identified by the provided Id from the request.")]
     public async Task<IActionResult> Update(
         CancellationToken cancellationToken,
         Guid id,

src/Umbraco.Cms.Api.Management/Controllers/Document/UpdateNotificationsController.cs

@@ -27,7 +27,7 @@ public UpdateNotificationsController(IContentEditingService contentEditingServic
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
     [EndpointSummary("Updates a document.")]
-    [EndpointDescription("Updates a document identified by the provided Id with the details from the request model.")]
+    [EndpointDescription("Updates a document identified by the provided Id from the request.")]
     public async Task<IActionResult> UpdateNotifications(CancellationToken cancellationToken, Guid id, UpdateDocumentNotificationsRequestModel updateModel)
     {
         IContent? content = await _contentEditingService.GetAsync(id);

src/Umbraco.Cms.Api.Management/Controllers/Document/UpdatePublicAccessDocumentController.cs

@@ -38,7 +38,7 @@ public UpdatePublicAccessDocumentController(
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
     [EndpointSummary("Updates a document.")]
-    [EndpointDescription("Updates a document identified by the provided Id with the details from the request model.")]
+    [EndpointDescription("Updates a document identified by the provided Id from the request.")]
     public async Task<IActionResult> Update(CancellationToken cancellationToken, Guid id, PublicAccessRequestModel requestModel)
     {
         AuthorizationResult authorizationResult = await _authorizationService.AuthorizeResourceAsync(