Updated articles

Author: eshanrnh

15/umbraco-ui-builder/miscellaneous/conventions.md

@@ -1,25 +1,32 @@
 ---
-description: Conventions used by Umbraco UI Builder, the backoffice UI builder for Umbraco.
+description: Guidelines for fluent configuration and naming conventions in Umbraco UI Builder.
 ---
 
 # Conventions
 
 ## Fluent Conventions
 
-Most configuration methods in Umbraco UI Builder aim to be fluent. This means that they return a relevant config instance allowing to chain multiple methods calls together in one. For those who prefer to be a bit more verbose, many methods also accept an optional lambda expression. This allows you to pass in a delegate to perform the inner configuration of the element being defined.
+Umbraco UI Builder follows a fluent configuration style, allowing method chaining for concise and readable code. Alternatively, a lambda expression can be used for a more structured approach.
+
+### Chaining Example
+
+```csharp
+config.AddSection("Repositories")
+      .Tree()
+      .AddCollection<People>(p => p.Id, "Person", "People");
+```
+
+### Lambda Expression Example Example
 
 ```csharp
-// Chaining example
-config.AddSection("Repositories").Tree().AddCollection<People>(p => p.Id, "Person", "People");
-
-// Delegate example
-config.AddSection("Repositories", sectionConfig => {
-    sectionConfig.Tree(treeConfig => {
-        treeConfig.AddCollection<People>(p => p.Id, "Person", "People");
-    });
+config.AddSection("Repositories", sectionConfig => {  
+    sectionConfig.Tree(treeConfig => {  
+        treeConfig.AddCollection<People>(p => p.Id, "Person", "People");  
+    });  
 });
 ```
 
 ## Naming Conventions
 
-Throughout the API, where a method name starts with **Add** then multiple configurations can be declared. Whereas if a method name starts with **Set** then only one instance of the configuration can be declared within the current configuration context.
+* Methods prefixed with **Add** allow multiple configurations.
+* Methods prefixed with **Set** permit only one instance within the current configuration context.

15/umbraco-ui-builder/miscellaneous/umbraco-aliases.md

@@ -1,27 +1,27 @@
 ---
-description: A list of useful Umbraco aliases for use with Umbraco UI Builder, the backoffice UI builder for Umbraco.
+description: Common Umbraco aliases used in Umbraco UI Builder for Sections, Dashboards, Workspace Views, and Trees.
 ---
 
 # Umbraco Aliases
 
-In a number of places in the Umbraco UI Builder API, you are required to know the aliases of other elements. For example, when you are adding sections, context apps, or dashboards before/after other instances. This is basic enough when it's referencing aliases of things defined in the Umbraco UI Builder config. However, for existing Umbraco instances it can be hard to find them so below is documented a number of known aliases for different elements.
+Umbraco UI Builder requires aliases for various elements, such as sections, context apps, and dashboards. While aliases for elements defined in the UI Builder config are straightforward, finding aliases for existing Umbraco instances can be challenging. Below is a list of known aliases for reference.
 
-## Dashboard aliases
+## Dashboard Aliases
 
-### **Content**
+### Content
 
 | Name | Alias |
 | -- | -- |
 | Getting Started | `contentIntro` |
 | Redirect URL Management | `contentRedirectManager` |
 
-### **Media**
+### Media
 
 | Name | Alias |
 | -- | -- |
 | Content | `mediaFolderBrowser` |
 
-### **Settings**
+### Settings
 
 | Name | Alias |
 | -- | -- |
@@ -31,36 +31,36 @@ In a number of places in the Umbraco UI Builder API, you are required to know th
 | Models Builder | `settingsModelsBuilder` |
 | Health Check | `settingsHealthCheck` |
 
-### **Members**
+### Members
 
 | Name | Alias |
 | -- | -- |
 | Getting Started | `memberIntro` |
 
-## Content App aliases
+## Workspace Views Aliases
 
-### **Content**
+### Content
 
 | Name | Alias |
 | -- | -- |
 | Content | `umbContent` |
 | Info | `umbInfo` |
 
-### **Media**
+### Media
 
 | Name | Alias |
 | -- | -- |
 | Content | `umbContent` |
 | Info | `umbInfo` |
 
-### **Members**
+### Members
 
 | Name | Alias |
 | -- | -- |
 | Content | `umbContent` |
 | Info | `umbInfo` |
 
-### **ContentTypes**
+### ContentTypes
 
 | Name | Alias |
 | -- | -- |
@@ -69,7 +69,7 @@ In a number of places in the Umbraco UI Builder API, you are required to know th
 | Permissions | `permissions` |
 | Templates | `templates` |
 
-## Section aliases
+## Section Aliases
 
 | Name | Alias |
 | -- | -- |
@@ -82,7 +82,7 @@ In a number of places in the Umbraco UI Builder API, you are required to know th
 | Forms | `forms` |
 | Translation | `translation` |
 
-## Tree aliases
+## Tree Aliases
 
 | Name | Alias |
 | -- | -- |