Incorporated review comments

Author: eshanrnh

15/umbraco-ui-builder/areas/sections.md

@@ -34,26 +34,38 @@ config.AddSection("Repositories", sectionConfig => {
 
 This method adds a section before another section with the specified alias, allowing for customized ordering of sections in the backoffice.
 
+#### Method Syntax
+
+```cs
+AddSectionBefore(string beforeAlias, string name, Lambda sectionConfig = null) : SectionConfigBuilder
+```
+
+#### Example
+
 ```csharp
 config.AddSectionBefore("settings", "Repositories", sectionConfig => {
     ...
 });
 ```
 
-**Code Reference:** `AddSectionBefore(string beforeAlias, string name, Lambda sectionConfig = null) : SectionConfigBuilder`
-
 ### Using the `AddSectionAfter()` Method
 
 This method adds a section after another section with the specified alias, allowing for a custom order of sections in the backoffice.
 
+#### Method Syntax
+
+```cs
+AddSectionAfter(string afterAlias, string name, Lambda sectionConfig = null) : SectionConfigBuilder
+```
+
+#### Example
+
 ```csharp
 config.AddSectionAfter("media", "Repositories", sectionConfig => {
     ...
 });
 ```
 
-**Code Reference:** `AddSectionAfter(string afterAlias, string name, Lambda sectionConfig = null) : SectionConfigBuilder`
-
 ## Customizing the Section Alias
 
 ### Setting a Custom Alias with `SetAlias()` Method
@@ -62,64 +74,94 @@ This method sets a custom alias for the section.
 
 *Optional:* By default, an alias is automatically generated from the section's name. To customize the alias, the `SetAlias()` method can be used.
 
+#### Method Syntax
+
+```cs
+SetAlias(string alias) : SectionConfigBuilder
+```
+
+#### Example
+
 ```csharp
 sectionConfig.SetAlias("repositories");
 ```
 
-**Code Reference:** `SetAlias(string alias) : SectionConfigBuilder`
-
 ## Configuring the Section Tree
 
 ### Using the `Tree()` Method for Configuration
 
 This method configures the tree structure for the section, which is used to organize content types. For more information, see the [Trees](trees.md) article.
 
+#### Method Syntax
+
+```cs
+Tree(Lambda treeConfig = null) : TreeConfigBuilder
+```
+
+#### Example
+
 ````csharp
 sectionConfig.Tree(treeConfig => {
     ...
 });
 ````
 
-**Code Reference:** `Tree(Lambda treeConfig = null) : TreeConfigBuilder`
-
 ## Adding Dashboards to the Section
 
 ### Adding a Dashboard with the `AddDashboard()` Method
 
 This method adds a dashboard to the section with the specified alias, providing tools and features for content management. For more information, see the [Dashboards](dashboards.md) article.
 
+#### Method Syntax
+
+```cs
+AddDashboard(string name, Lambda dashboardConfig = null) : DashboardConfigBuilder
+```
+
+#### Example
+
 ```csharp
 sectionConfig.AddDashboard("Team", dashboardConfig => {
     ...
 });
 ```
 
-**Code Reference:** AddDashboard(string name, Lambda dashboardConfig = null) : DashboardConfigBuilder
-
 ### Using `AddDashboardBefore()` to Place a Dashboard
 
 This method adds a dashboard before another dashboard with the specified alias, allowing custom placement in the section. For more information, see the [Dashboards](dashboards.md) article.
 
+#### Method Syntax
+
+```cs
+AddDashboardBefore(string beforeAlias, string name, Lambda dashboardConfig = null) : DashboardConfigBuilder
+```
+
+#### Example
+
 ```csharp
 sectionConfig.AddDashboardBefore("contentIntro", "Team", dashboardConfig => {
     ...
 });
 ```
 
-**Code Reference:** `AddDashboardBefore(string beforeAlias, string name, Lambda dashboardConfig = null) : DashboardConfigBuilder`
-
 ### Using `AddDashboardAfter()` to Place a Dashboard
 
 This method adds a dashboard after another dashboard with the specified alias, giving control over dashboard order. For more information, see the [Dashboards](dashboards.md) article.
 
+#### Method Syntax
+
+```cs
+AddDashboardAfter(string afterAlias, string name, Lambda dashboardConfig = null) : DashboardConfigBuilder
+```
+
+#### Example
+
 ```csharp
 sectionConfig.AddDashboardAfter("contentIntro", "Team", dashboardConfig => {
     ...
 });
 ```
 
-**Code Reference:** `AddDashboardAfter(string afterAlias, string name, Lambda dashboardConfig = null) : DashboardConfigBuilder`
-
 ## Extending Existing Sections
 
 You can extend existing sections by adding Umbraco UI Builder trees and dashboards, context apps, and virtual subtrees. This can be done by calling the `WithSection` method on the root-level `UIBuilderConfigBuilder` instance.
@@ -128,100 +170,148 @@ You can extend existing sections by adding Umbraco UI Builder trees and dashboar
 
 This method extends an existing section with additional configuration, enabling more customization for existing areas.
 
+#### Method Syntax
+
+```cs
+WithSection(string alias, Lambda sectionConfig = null) : WithSectionConfigBuilder
+```
+
+#### Example
+
 ```csharp
 config.WithSection("member", withSectionConfig => {
     ...
 });
 ```
 
-**Code Reference:** `WithSection(string alias, Lambda sectionConfig = null) : WithSectionConfigBuilder`
-
 ## Adding Trees to an Existing Section
 
 ### Using the `AddTree()` Method
 
 This method adds a tree to the section, helping to visualize and organize content types. For more information, see the [Trees](trees.md) article.
 
+#### Method Syntax
+
+```cs
+AddTree(string name, string icon, Lambda treeConfig = null) : TreeConfigBuilder
+```
+
+#### Example
+
 ````csharp
 withSectionConfig.AddTree("My Tree", "icon-folder", treeConfig => {
     ...
 });
 ````
 
-**Code Reference:** `AddTree(string name, string icon, Lambda treeConfig = null) : TreeConfigBuilder`
-
 ### Grouping Trees with `AddTree()` Method
 
 This method adds a tree within a specified group, improving content organization by grouping related trees together. For more information, see the [Trees](trees.md) article.
 
+#### Method Syntax
+
+```cs
+AddTree(string groupName, string name, string icon, Lambda treeConfig = null) : TreeConfigBuilder
+```
+
+#### Example
+
 ````csharp
 withSectionConfig.AddTree("My Group", "My Tree", "icon-folder", treeConfig => {
     ...
 });
 ````
 
-**Code Reference:** `AddTree(string groupName, string name, string icon, Lambda treeConfig = null) : TreeConfigBuilder`
-
 ## Adding a Tree Before or After an Existing Tree
 
 ### Using `AddTreeBefore()` to Position a Tree
 
 This method adds a tree before another tree within the section, allowing you to customize the tree order. For more information, see the [Trees](trees.md) article.
 
+#### Method Syntax
+
+```cs
+AddTreeBefore(string treeAlias, string name, string icon, Lambda treeConfig = null) : TreeConfigBuilder
+```
+
+#### Example
+
 ````csharp
 withSectionConfig.AddTreeBefore("member", "My Tree", "icon-folder", treeConfig => {
     ...
 });
 ````
 
-**Code Reference:** `AddTreeBefore(string treeAlias, string name, string icon, Lambda treeConfig = null) : TreeConfigBuilder`
-
 ### Using `AddTreeAfter()` to Position a Tree
 
 This method adds a tree after another tree within the section, enabling specific ordering of trees. For more information, see the [Trees](trees.md) article.
 
+#### Method Syntax
+
+```cs
+AddTreeAfter(string treeAlias, string name, string icon, Lambda treeConfig = null) : TreeConfigBuilder
+```
+
+#### Example
+
 ````csharp
 withSectionConfig.AddTreeAfter("member", "My Tree", "icon-folder", treeConfig => {
     ...
 });
 ````
 
-**Code Reference:** `AddTreeAfter(string treeAlias, string name, string icon, Lambda treeConfig = null) : TreeConfigBuilder`
-
 ## Adding a Dashboard to an Existing Section
 
 ### Using the `AddDashboard()` Method
 
 This method adds a new dashboard to the section with the specified name. For more information, see the [Dashboards](dashboards.md) article.
 
+#### Method Syntax
+
+```cs
+AddDashboard (string name, Lambda dashboardConfig = null) : DashboardConfigBuilder
+```
+
+#### Example
+
 ```csharp
 withSectionConfig.AddDashboard("Team", dashboardConfig => {
     ...
 });
 ```
 
-**Code Reference:** `AddDashboard (string name, Lambda dashboardConfig = null) : DashboardConfigBuilder`
-
 ### Using the `AddDashboardBefore()` Method
 
 This method adds a dashboard before the dashboard with the specified alias. For more information, see the [Dashboards](dashboards.md) article.
 
+#### Method Syntax
+
+```cs
+AddDashboardBefore (string beforeAlias, string name, Lambda dashboardConfig = null) : DashboardConfigBuilder
+```
+
+#### Example
+
 ```csharp
 withSectionConfig.AddDashboardBefore("contentIntro", "Team", dashboardConfig => {
     ...
 });
 ```
 
-**Code Reference:** `AddDashboardBefore (string beforeAlias, string name, Lambda dashboardConfig = null) : DashboardConfigBuilder`
-
 ### Using the `AddDashboardAfter()` Method
 
 This method adds a dashboard after the dashboard with the specified alias. For more information, see the [Dashboards](dashboards.md) article.
 
+#### Method Syntax
+
+```cs
+AddDashboardAfter (string afterAlias, string name, Lambda dashboardConfig = null) : DashboardConfigBuilder
+```
+
+#### Example
+
 ```csharp
 withSectionConfig.AddDashboardAfter("contentIntro", "Team", dashboardConfig => {
     ...
 });
 ```
-
-**Code Reference:** `AddDashboardAfter (string afterAlias, string name, Lambda dashboardConfig = null) : DashboardConfigBuilder`