diff --git a/15/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md b/15/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md
index ea01a688e02..7069536b13f 100644
--- a/15/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md
+++ b/15/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md
@@ -1,18 +1,12 @@
---
-description: A guide to creating a section
+description: Introducing Section extensions, a home for custom content and functionality.
---
-# Sections
+# Section
-{% hint style="warning" %}
-This page is a work in progress and may undergo further revisions, updates, or amendments. The information contained herein is subject to change without notice.
-{% endhint %}
+Umbraco extension authors can place their extension in the top-level navigation of the backoffice using Sections. The extension will be placed among the default options such as Content, Media, Settings, etc.
-The Umbraco backoffice consists of Sections. Section is the main division shown in the top navigation.
-
-For example, when you load the backoffice, you'll see the 'Content' section, 'Settings' section, and so on.
-
-You can create your own sections to extend Umbraco with room for more features.
+Within the section, authors can add menus, section views, workspace views, or any other content or interface they desire.
Section
@@ -20,11 +14,10 @@ You can create your own sections to extend Umbraco with room for more features.
### **Manifests**
-When creating a new section it's recommended to use a [Entry Point](../backoffice-entry-point.md)-extension in your [Umbraco Package Manifest](../../../umbraco-package.md). This is to get better control over all the additional extensions required for the new section.
+Sections can be created by adding a definition in the extension's manifest file.
-Create a section by defining a manifest for it:
-
-```typescript
+{% code title="umbraco-package.json" %}
+```json
{
"type": "section",
"alias": "My.Section",
@@ -35,31 +28,33 @@ Create a section by defining a manifest for it:
}
}
```
+{% endcode %}
-Once registered, you will be able to select this action for your User Group Permissions. Once that is permitted, you can view your section.
+### **Group permissions**
-
Section
+To enable custom sections for backoffice users, site administrators must first assign permissions to those users. This involves configuring the permission for a user group and assigning users to that group.
+
+To grant access to the custom section, open the Umbraco backoffice, navigate to the **Users** section, and select the **User groups** menu item. Site administrators can create a new user group or modify an existing one.
-#### **Extend with Sidebar, Dashboards and more**
+Once the user group is open, click the **Choose** button under the Sections section. Select the custom section from the slide-out modal to enable access.
-Once a section is registered, it can be extended like any other section.
+
Enabling new Sections
-Here is a list of appropriate extensions to append to your section:
+After assigning permission, users may need to reload the backoffice for the changes to take effect.
+
+
Section
-* [Creating a Custom Dashboard](../../../../tutorials/creating-a-custom-dashboard/)
-* [Section Sidebar](section-sidebar.md)
-* [Section View](section-view.md)
+## **Extend with Sidebar, Dashboards, and more**
-#### **Manifest with empty element**
+Sections serve as blank canvases within the Umbraco backoffice. Extension authors can integrate other Umbraco extensions into sections, including [custom dashboards](../../../../tutorials/creating-a-custom-dashboard/), [sidebars](section-sidebar.md), and [section views](section-view.md).
-If you prefer full control over the content of your section you can choose to define an element for the content of your section.
+Section authors can also skip Umbraco backoffice components and build a fully custom view by creating an empty element.
-{% hint style="warning" %}
-This is not recommended as it limits the content of your section to this element. Instead, it is recommended to use a single Dashboard or Section View.
-{% endhint %}
+### **Manifest with empty element**
-If you like to have full control, you can define an element like this:
+Using a manifest with only an element is not recommended if you are shipping this as a package. This approach limits the Section to a single element. Instead, use a Dashboard or Section View for your main view, which allows additional Dashboards or Section Views to be added to the Section.
+{% code title="manifests.ts" %}
```typescript
const section : UmbExtensionManifest = {
type: "section",
@@ -72,5 +67,6 @@ const section : UmbExtensionManifest = {
}
}
```
+{% endcode %}
-The element file must have an `element` or `default` export, or specify the element name in the `elementName` field.
+The element file must contain an `element`, a `default` export, or specify the element name in the `elementName` field.
diff --git a/16/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md b/16/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md
index 6b8679c56e2..d52d9db6949 100644
--- a/16/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md
+++ b/16/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md
@@ -44,10 +44,6 @@ After assigning permission, users may need to reload the backoffice for the chan
Section
-### **Entry points**
-
-When creating a new section, create an [Entry Point](../backoffice-entry-point.md) extension in the [Umbraco Package Manifest](../../../umbraco-package.md) to complement it. Entry Point extensions add initialization and teardown lifecycle events that may be helpful in coordinating behavior inside the section.
-
## **Extend with Sidebar, Dashboards, and more**
Sections serve as blank canvases within the Umbraco backoffice. Extension authors can integrate other Umbraco extensions into sections, including [custom dashboards](../../../../tutorials/creating-a-custom-dashboard/), [sidebars](section-sidebar.md), and [section views](section-view.md).
@@ -56,9 +52,7 @@ Section authors can also skip Umbraco backoffice components and build a fully cu
### **Manifest with empty element**
-{% hint style="warning" %}
-This approach is not recommended because it restricts content to a single element. Instead, use a Dashboard or Section View.
-{% endhint %}
+Using a manifest with only an element is not recommended if you are shipping this as a package. This approach limits the Section to a single element. Instead, use a Dashboard or Section View for your main view, which allows additional Dashboards or Section Views to be added to the Section.
{% code title="manifests.ts" %}
```typescript
diff --git a/17/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md b/17/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md
index 6b8679c56e2..7069536b13f 100644
--- a/17/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md
+++ b/17/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md
@@ -36,7 +36,7 @@ To enable custom sections for backoffice users, site administrators must first a
To grant access to the custom section, open the Umbraco backoffice, navigate to the **Users** section, and select the **User groups** menu item. Site administrators can create a new user group or modify an existing one.
-Once the user group is open, click the **Choose** button under the Sections section. Select the custom section from the slide-out modal to enable access.
+Once the user group is open, click the **Choose** button under the Sections section. Select the custom section from the slide-out modal to enable access.
Enabling new Sections
@@ -44,10 +44,6 @@ After assigning permission, users may need to reload the backoffice for the chan
Section
-### **Entry points**
-
-When creating a new section, create an [Entry Point](../backoffice-entry-point.md) extension in the [Umbraco Package Manifest](../../../umbraco-package.md) to complement it. Entry Point extensions add initialization and teardown lifecycle events that may be helpful in coordinating behavior inside the section.
-
## **Extend with Sidebar, Dashboards, and more**
Sections serve as blank canvases within the Umbraco backoffice. Extension authors can integrate other Umbraco extensions into sections, including [custom dashboards](../../../../tutorials/creating-a-custom-dashboard/), [sidebars](section-sidebar.md), and [section views](section-view.md).
@@ -56,9 +52,7 @@ Section authors can also skip Umbraco backoffice components and build a fully cu
### **Manifest with empty element**
-{% hint style="warning" %}
-This approach is not recommended because it restricts content to a single element. Instead, use a Dashboard or Section View.
-{% endhint %}
+Using a manifest with only an element is not recommended if you are shipping this as a package. This approach limits the Section to a single element. Instead, use a Dashboard or Section View for your main view, which allows additional Dashboards or Section Views to be added to the Section.
{% code title="manifests.ts" %}
```typescript
@@ -75,5 +69,4 @@ const section : UmbExtensionManifest = {
```
{% endcode %}
-The element file must contain an `element`, a `default` export, or specify the element name in the
-`elementName` field.
+The element file must contain an `element`, a `default` export, or specify the element name in the `elementName` field.
