Adds example of publishing content with descendants

Author: AndyButland

15/umbraco-cms/reference/management/using-services/contentservice.md

@@ -1,5 +1,5 @@
 ---
-description: Example on how to create content programmatically using the ContentService.
+description: Example on how to create and publish content programmatically using the ContentService.
 ---
 
 # Content Service
@@ -11,35 +11,77 @@ Learn how to use the Content Service.
 In the example below, a new page is programmatically created using the content service. It is assumed that there are two document types, namely Catalogue and Product. In this case, a new Product is added underneath the Catalogue page. Add the below code in the Catalogue template.
 
 ```csharp
-// Get access to ContentService - Add this at the top of your razor view
-@inject IContentService ContentService
-@using Umbraco.Cms.Core.Services
+using Umbraco.Cms.Core.Models;
+using Umbraco.Cms.Core.Services;
 
-// Add this anywhere in your Catalogue template
-@{
-    // Create a variable for the GUID of the parent page - Catalogue, where you want to add a child item.
-    var parentId = Guid.Parse("b6fbbb31-a77f-4f9c-85f7-2dc4835c7f31");
+namespace Umbraco.Cms.Web.UI.Custom;
 
-    // Create a new child item of type 'Product'
-    var demoproduct = ContentService.Create("Microphone", parentId, "product"); 
+public class PublishContentDemo
+{
+    private readonly IContentService _contentService;
 
-    // Set the value of the property with alias 'category'
-    demoproduct.SetValue("category" , "audio");
+    public PublishContentDemo(IContentService contentService) => _contentService = contentService;
 
-    // Set the value of the property with alias 'price'
-    demoproduct.SetValue("price", "1500");
+    public void Create()
+    {
+        // Create a variable for the GUID of the parent page - Catalogue, where you want to add a child item.
+        var parentId = Guid.Parse("b6fbbb31-a77f-4f9c-85f7-2dc4835c7f31");
 
-    // Save and publish the child item
-    ContentService.SaveAndPublish(demoproduct);
-    
+        // Create a new child item of type 'Product'
+        var demoProduct = ContentService.Create("Microphone", parentId, "product");
+
+        // Set the value of the property with alias 'category'
+        demoProduct.SetValue("category" , "audio");
+
+        // Set the value of the property with alias 'price'
+        demoProduct.SetValue("price", "1500");
+
+        // Save and publish the child item
+        _contentService.SaveAndPublish(demoProduct);
+    }
 }
 ```
 
-In a multilanguage setup, it is necessary to set the name of the content item for a specified culture:
+In a multi-language setup, it is necessary to set the name of the content item for a specified culture:
 
 ```csharp
-demoproduct.SetCultureName("Microphone", "en-us"); // this will set the english name
-demoproduct.SetCultureName("Mikrofon", "da"); // this will set the danish name
+demoProduct.SetCultureName("Microphone", "en-us"); // this will set the english name
+demoProduct.SetCultureName("Mikrofon", "da"); // this will set the danish name
 ```
 
 For information on how to retrieve multilingual languages, see the [Retrieving languages](./retrieving-languages.md) article.
+
+## Publishing content programmatically
+
+The ContentService is also used for publishing operations.
+
+The following example shows a page being published with all descendants.
+
+```csharp
+using Umbraco.Cms.Core.Models;
+using Umbraco.Cms.Core.Services;
+
+namespace Umbraco.Cms.Web.UI.Custom;
+
+public class PublishContentDemo
+{
+    private readonly IContentService _contentService;
+
+    public PublishContentDemo(IContentService contentService) => _contentService = contentService;
+
+    public void Publish(Guid key)
+    {
+        IContent? content = _contentService.GetById(key)
+            ?? throw new InvalidOperationException($"Could not find content with key: {key}.");
+
+        _contentService.SaveAndPublishBranch(content, PublishBranchFilter.Default);
+    }
+}
+```
+
+The `PublishBranchFilter` option can include one or more of the following flags:
+
+- `Default` - publishes existing published content with pending changes
+- `IncludeUnpublished` - publishes unpublished content and existing published with pending changes
+- `ForceRepublish` - publishes existing published content with or without pending changes
+- `All` - combines `IncludeUnpublished` and `ForceRepublish`