Updated to Controllers/Document controllers

src/Umbraco.Cms.Api.Management/Controllers/Culture/AllCultureController.cs

@@ -21,10 +21,6 @@ public AllCultureController(IUmbracoMapper umbracoMapper, ICultureService cultur
         _cultureService = cultureService;
     }
 
-    /// <summary>
-    ///     Returns all cultures available for creating languages.
-    /// </summary>
-    /// <returns></returns>
     [HttpGet]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(PagedViewModel<CultureReponseModel>), StatusCodes.Status200OK)]

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

@@ -36,7 +36,7 @@ public NotificationsController(
     [ProducesResponseType(typeof(IEnumerable<DocumentNotificationResponseModel>), StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
     [EndpointSummary("Gets notifications for a document.")]
-    [EndpointDescription("Gets the notification settings for the document identified by the provided Id.")]
+    [EndpointDescription("Gets the notifications for the document identified by the provided Id.")]
     public async Task<IActionResult> Notifications(CancellationToken cancellationToken, Guid id)
     {
         AuthorizationResult authorizationResult = await _authorizationService.AuthorizeResourceAsync(

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

@@ -32,8 +32,8 @@ public UpdateDomainsController(IDomainService domainService, IUmbracoMapper umbr
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [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.")]
+    [EndpointSummary("Updates the domains for a document.")]
+    [EndpointDescription("Updates the domains for the document identified by the provided Id with the details from the request model.")]
     public async Task<IActionResult> Update(
         CancellationToken cancellationToken,
         Guid id,

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

@@ -26,8 +26,8 @@ public UpdateNotificationsController(IContentEditingService contentEditingServic
     [HttpPut("{id:guid}/notifications")]
     [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.")]
+    [EndpointSummary("Updates notification subscriptions for a document.")]
+    [EndpointDescription("Updates which actions the current user is subscribed to receive notifications for on the specified document.")]
     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

@@ -37,8 +37,8 @@ public UpdatePublicAccessDocumentController(
     [MapToApiVersion("1.0")]
     [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.")]
+    [EndpointSummary("Updates public access protection for a document.")]
+    [EndpointDescription("Updates the member protection settings for a document, controlling which members or member groups can access it.")]
     public async Task<IActionResult> Update(CancellationToken cancellationToken, Guid id, PublicAccessRequestModel requestModel)
     {
         AuthorizationResult authorizationResult = await _authorizationService.AuthorizeResourceAsync(

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/ByKeyDocumentBlueprintController.cs

@@ -27,8 +27,8 @@ public ByKeyDocumentBlueprintController(IContentBlueprintEditingService contentB
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(DocumentBlueprintResponseModel), StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Gets a document blueprint.")]
-    [EndpointDescription("Gets a document blueprint identified by the provided Id.")]
+    [EndpointSummary("Gets a Document Blueprint.")]
+    [EndpointDescription("Gets a Document Blueprint identified by the provided Id.")]
     public async Task<IActionResult> ByKey(CancellationToken cancellationToken, Guid id)
     {
         IContent? blueprint = await _contentBlueprintEditingService.GetAsync(id);

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/CreateDocumentBlueprintController.cs

@@ -36,8 +36,8 @@ public CreateDocumentBlueprintController(
     [ProducesResponseType(StatusCodes.Status201Created)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Creates a new documentblueprint.")]
-    [EndpointDescription("Creates a new documentblueprint with the configuration specified in the request model.")]
+    [EndpointSummary("Creates a new Document Blueprint.")]
+    [EndpointDescription("Creates a new Document Blueprint with the configuration specified in the request model.")]
     public async Task<IActionResult> Create(CancellationToken cancellationToken, CreateDocumentBlueprintRequestModel requestModel)
     {
         ContentBlueprintCreateModel model = _blueprintEditingPresentationFactory.MapCreateModel(requestModel);

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/CreateDocumentBlueprintFromDocumentController.cs

@@ -40,8 +40,8 @@ public CreateDocumentBlueprintFromDocumentController(
     [MapToApiVersion("1.0")]
     [ProducesResponseType(StatusCodes.Status201Created)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Creates a document blueprint from an existing document.")]
-    [EndpointDescription("Creates a new document blueprint based on an existing document identified by the provided Id.")]
+    [EndpointSummary("Creates a Document Blueprint from an existing document.")]
+    [EndpointDescription("Creates a new Document Blueprint based on an existing document identified by the provided Id.")]
     public async Task<IActionResult> CreateFromDocument(CancellationToken cancellationToken, CreateDocumentBlueprintFromDocumentRequestModel fromDocumentRequestModel)
     {
         AuthorizationResult authorizationResult = await _authorizationService.AuthorizeResourceAsync(

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/DeleteDocumentBlueprintController.cs

@@ -29,8 +29,8 @@ public DeleteDocumentBlueprintController(IContentBlueprintEditingService content
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Deletes a document blueprint.")]
-    [EndpointDescription("Deletes a document blueprint identified by the provided Id.")]
+    [EndpointSummary("Deletes a Document Blueprint.")]
+    [EndpointDescription("Deletes a Document Blueprint identified by the provided Id.")]
     public async Task<IActionResult> Delete(CancellationToken cancellationToken, Guid id)
     {
         Attempt<IContent?, ContentEditingOperationStatus> result = await _contentBlueprintEditingService.DeleteAsync(id, CurrentUserKey(_backOfficeSecurityAccessor));

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/DocumentBlueprintControllerBase.cs

@@ -13,6 +13,6 @@ public abstract class DocumentBlueprintControllerBase : ContentControllerBase
     protected IActionResult DocumentBlueprintNotFound()
         => OperationStatusResult(ContentEditingOperationStatus.NotFound, problemDetailsBuilder
             => NotFound(problemDetailsBuilder
-                .WithTitle("The document blueprint could not be found")
+                .WithTitle("The Document Blueprint could not be found")
                 .Build()));
 }

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Folder/CreateDocumentBlueprintFolderController.cs

@@ -22,8 +22,8 @@ public CreateDocumentBlueprintFolderController(
     [ProducesResponseType(StatusCodes.Status201Created)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Creates a documentblueprint folder.")]
-    [EndpointDescription("Creates a new documentblueprint folder with the provided name and parent location.")]
+    [EndpointSummary("Creates a Document Blueprint folder.")]
+    [EndpointDescription("Creates a new Document Blueprint folder with the provided name and parent location.")]
     public async Task<IActionResult> Create(CancellationToken cancellationToken, CreateFolderRequestModel createFolderRequestModel)
         => await CreateFolderAsync<ByKeyDocumentBlueprintFolderController>(
             createFolderRequestModel,

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Folder/DeleteDocumentBlueprintFolderController.cs

@@ -21,7 +21,7 @@ public DeleteDocumentBlueprintFolderController(
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Deletes a document blueprint folder.")]
-    [EndpointDescription("Deletes a document blueprint folder identified by the provided Id.")]
+    [EndpointSummary("Deletes a Document Blueprint folder.")]
+    [EndpointDescription("Deletes a Document Blueprint folder identified by the provided Id.")]
     public async Task<IActionResult> Delete(CancellationToken cancellationToken, Guid id) => await DeleteFolderAsync(id);
 }

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Folder/UpdateDocumentBlueprintFolderController.cs

@@ -22,8 +22,8 @@ public UpdateDocumentBlueprintFolderController(
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Updates a document blueprint folder.")]
-    [EndpointDescription("Updates a document blueprint folder identified by the provided Id with the details from the request model.")]
+    [EndpointSummary("Updates a Document Blueprint folder.")]
+    [EndpointDescription("Updates a Document Blueprint folder identified by the provided Id with the details from the request model.")]
     public async Task<IActionResult> Update(CancellationToken cancellationToken, Guid id, UpdateFolderResponseModel updateFolderResponseModel)
         => await UpdateFolderAsync(id, updateFolderResponseModel);
 }

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Item/ItemDocumentBlueprintController.cs

@@ -25,8 +25,8 @@ public ItemDocumentBlueprintController(IEntityService entityService, IDocumentPr
     [HttpGet]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<DocumentBlueprintItemResponseModel>), StatusCodes.Status200OK)]
-    [EndpointSummary("Gets a collection of document blueprint items.")]
-    [EndpointDescription("Gets a collection of document blueprint items identified by the provided Ids.")]
+    [EndpointSummary("Gets a collection of Document Blueprint items.")]
+    [EndpointDescription("Gets a collection of Document Blueprint items identified by the provided Ids.")]
     public Task<IActionResult> Item(
         CancellationToken cancellationToken,
         [FromQuery(Name = "id")] HashSet<Guid> ids)

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/MoveDocumentBlueprintController.cs

@@ -28,8 +28,8 @@ public MoveDocumentBlueprintController(IContentBlueprintEditingService contentBl
     [MapToApiVersion("1.0")]
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Moves a document blueprint.")]
-    [EndpointDescription("Moves a document blueprint identified by the provided Id to a different location.")]
+    [EndpointSummary("Moves a Document Blueprint.")]
+    [EndpointDescription("Moves a Document Blueprint identified by the provided Id to a different location.")]
     public async Task<IActionResult> Move(CancellationToken cancellationToken, Guid id, MoveDocumentBlueprintRequestModel requestModel)
     {
         Attempt<ContentEditingOperationStatus> result = await _contentBlueprintEditingService.MoveAsync(id, requestModel.Target?.Id, CurrentUserKey(_backOfficeSecurityAccessor));

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/ScaffoldDocumentBlueprintController.cs

@@ -27,8 +27,8 @@ public ScaffoldDocumentBlueprintController(IContentBlueprintEditingService conte
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(DocumentBlueprintResponseModel), StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Scaffolds a document blueprint.")]
-    [EndpointDescription("Creates a scaffold for a new document blueprint with default values.")]
+    [EndpointSummary("Scaffolds a Document Blueprint.")]
+    [EndpointDescription("Creates a scaffold for a new Document Blueprint with default values.")]
     public async Task<IActionResult> Scaffold(CancellationToken cancellationToken, Guid id)
     {
         IContent? blueprint = await _contentBlueprintEditingService.GetScaffoldedAsync(id);

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Tree/AncestorsDocumentBlueprintTreeController.cs

@@ -27,8 +27,8 @@ public AncestorsDocumentBlueprintTreeController(IEntityService entityService, Fl
     [HttpGet("ancestors")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(IEnumerable<DocumentBlueprintTreeItemResponseModel>), StatusCodes.Status200OK)]
-    [EndpointSummary("Gets a collection of ancestor document blueprint items.")]
-    [EndpointDescription("Gets a collection of document blueprint items that are ancestors to the provided Id.")]
+    [EndpointSummary("Gets a collection of ancestor Document Blueprint items.")]
+    [EndpointDescription("Gets a collection of Document Blueprint items that are ancestors to the provided Id.")]
     public async Task<ActionResult<IEnumerable<DocumentBlueprintTreeItemResponseModel>>> Ancestors(CancellationToken cancellationToken, Guid descendantId)
         => await GetAncestors(descendantId);
 }

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Tree/ChildrenDocumentBlueprintTreeController.cs

@@ -28,8 +28,8 @@ public ChildrenDocumentBlueprintTreeController(IEntityService entityService, Fla
     [HttpGet("children")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(PagedViewModel<DocumentBlueprintTreeItemResponseModel>), StatusCodes.Status200OK)]
-    [EndpointSummary("Gets a collection of document blueprint tree child items.")]
-    [EndpointDescription("Gets a paginated collection of document blueprint tree items that are children of the provided parent Id.")]
+    [EndpointSummary("Gets a collection of Document Blueprint tree child items.")]
+    [EndpointDescription("Gets a paginated collection of Document Blueprint tree items that are children of the provided parent Id.")]
     public async Task<ActionResult<PagedViewModel<DocumentBlueprintTreeItemResponseModel>>> Children(CancellationToken cancellationToken, Guid parentId, int skip = 0, int take = 100, bool foldersOnly = false)
     {
         RenderFoldersOnly(foldersOnly);

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Tree/RootDocumentBlueprintTreeController.cs

@@ -28,8 +28,8 @@ public RootDocumentBlueprintTreeController(IEntityService entityService, FlagPro
     [HttpGet("root")]
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(PagedViewModel<DocumentBlueprintTreeItemResponseModel>), StatusCodes.Status200OK)]
-    [EndpointSummary("Gets a collection of document blueprint items from the root of the tree.")]
-    [EndpointDescription("Gets a paginated collection of document blueprint items from the root of the tree with optional filtering.")]
+    [EndpointSummary("Gets a collection of Document Blueprint items from the root of the tree.")]
+    [EndpointDescription("Gets a paginated collection of Document Blueprint items from the root of the tree with optional filtering.")]
     public async Task<ActionResult<PagedViewModel<DocumentBlueprintTreeItemResponseModel>>> Root(
         CancellationToken cancellationToken,
         int skip = 0,

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/Tree/SiblingsDocumentBlueprintTreeController.cs

@@ -25,8 +25,8 @@ public SiblingsDocumentBlueprintTreeController(IEntityService entityService, Fla
 
     [HttpGet("siblings")]
     [ProducesResponseType(typeof(SubsetViewModel<DocumentBlueprintTreeItemResponseModel>), StatusCodes.Status200OK)]
-    [EndpointSummary("Gets a collection of document blueprint tree sibling items.")]
-    [EndpointDescription("Gets a collection of document blueprint tree items that are siblings of the provided Id.")]
+    [EndpointSummary("Gets a collection of Document Blueprint tree sibling items.")]
+    [EndpointDescription("Gets a collection of Document Blueprint tree items that are siblings of the provided Id.")]
     public async Task<ActionResult<SubsetViewModel<DocumentBlueprintTreeItemResponseModel>>> Siblings(
         CancellationToken cancellationToken,
         Guid target,

src/Umbraco.Cms.Api.Management/Controllers/DocumentBlueprint/UpdateDocumentBlueprintController.cs

@@ -36,8 +36,8 @@ public UpdateDocumentBlueprintController(
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Updates a document blueprint.")]
-    [EndpointDescription("Updates a document blueprint identified by the provided Id with the details from the request model.")]
+    [EndpointSummary("Updates a Document Blueprint.")]
+    [EndpointDescription("Updates a Document Blueprint identified by the provided Id with the details from the request model.")]
     public async Task<IActionResult> Update(CancellationToken cancellationToken, Guid id, UpdateDocumentBlueprintRequestModel requestModel)
     {
         ContentBlueprintUpdateModel model = _blueprintEditingPresentationFactory.MapUpdateModel(requestModel);

src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Folder/ByKeyDocumentTypeFolderController.cs

@@ -21,7 +21,7 @@ public ByKeyDocumentTypeFolderController(
     [MapToApiVersion("1.0")]
     [ProducesResponseType(typeof(FolderResponseModel), StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Gets a document type folder.")]
-    [EndpointDescription("Gets a document type folder identified by the provided Id.")]
+    [EndpointSummary("Gets a Document Type folder.")]
+    [EndpointDescription("Gets a Document Type folder identified by the provided Id.")]
     public async Task<IActionResult> ByKey(CancellationToken cancellationToken, Guid id) => await GetFolderAsync(id);
 }

src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Folder/CreateDocumentTypeFolderController.cs

@@ -22,8 +22,8 @@ public CreateDocumentTypeFolderController(
     [ProducesResponseType(StatusCodes.Status201Created)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Creates a document type folder.")]
-    [EndpointDescription("Creates a new document type folder with the provided name and parent location.")]
+    [EndpointSummary("Creates a Document Type folder.")]
+    [EndpointDescription("Creates a new Document Type folder with the provided name and parent location.")]
     public async Task<IActionResult> Create(
         CancellationToken cancellationToken,
         CreateFolderRequestModel createFolderRequestModel)

src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Folder/DeleteDocumentTypeFolderController.cs

@@ -21,7 +21,7 @@ public DeleteDocumentTypeFolderController(
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Deletes a document type folder.")]
-    [EndpointDescription("Deletes a document type folder identified by the provided Id.")]
+    [EndpointSummary("Deletes a Document Type folder.")]
+    [EndpointDescription("Deletes a Document Type folder identified by the provided Id.")]
     public async Task<IActionResult> Delete(CancellationToken cancellationToken, Guid id) => await DeleteFolderAsync(id);
 }

src/Umbraco.Cms.Api.Management/Controllers/DocumentType/Folder/UpdateDocumentTypeFolderController.cs

@@ -22,8 +22,8 @@ public UpdateDocumentTypeFolderController(
     [ProducesResponseType(StatusCodes.Status200OK)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
     [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
-    [EndpointSummary("Updates a document type folder.")]
-    [EndpointDescription("Updates a document type folder identified by the provided Id with the details from the request model.")]
+    [EndpointSummary("Updates a Document Type folder.")]
+    [EndpointDescription("Updates a Document Type folder identified by the provided Id with the details from the request model.")]
     public async Task<IActionResult> Update(
         CancellationToken cancellationToken,
         Guid id,