Updated articles within the filtering section

Author: eshanrnh

15/umbraco-ui-builder/filtering/data-views-builders.md

@@ -1,16 +1,16 @@
 ---
-description: Configuring data views builders in Umbraco UI Builder, the backoffice UI builder for Umbraco.
+description: Learn how to configure data views builders in Umbraco UI Builder.
 ---
 
 # Data Views Builders
 
-Data views builders allow you to create a collection data views list dynamically at run time. By default, Umbraco UI Builder will use the hard-coded data views defined in your Umbraco UI Builder config. However, if you need to build your data views list dynamically, then this is when you'd use a data views builder.
+Data views builders allow you to create a collection’s data views dynamically at runtime. By default, Umbraco UI Builder uses hard-coded data views from the configuration. However, if you need to generate data views dynamically, a data views builder is required.
 
-When Umbraco UI Builder resolves a data views builder it will attempt to do so from the global DI container. This means you can inject any dependencies that you require for your builder. If there is no type defined in the DI container, Umbraco UI Builder will fall-back to manually instantiating a new instance of value mapper.
+When resolving a data views builder, Umbraco UI Builder first attempts to retrieve it from the global Dependency Injection (DI) container. This allows injecting required dependencies into the builder. If no type is defined in the DI container, Umbraco UI Builder falls back to manually instantiating a new instance of the value mapper.
 
-## Defining a data views builder
+## Defining a Data Views Builder
 
-To define a data views builder you can create a class that inherits from the base class `DataViewsBuilder<TEntityType>` and implements the abstract methods.
+To define a data views builder, create a class that inherits from `DataViewsBuilder<TEntityType>` and implements the required abstract methods.
 
 ````csharp
 // Example
@@ -33,33 +33,54 @@ The required methods are:
 * **GetDataViews:** Returns the list of data views to choose from.
 * **GetDataViewWhereClause:** Returns the boolean **where clause** expression for the given data views alias.
 
-## Setting the data views builder of a collection
+## Setting the Data Views Builder of a Collection
 
-Setting a data views builder is controlled via the [collections](../collections/overview.md) configuration.
+Setting a data views builder is controlled via the [Collections](../collections/overview.md) settings.
 
-### **SetDataViewsBuilder&lt;TDataViewsBuilder&gt;() : CollectionConfigBuilder&lt;TEntityType&gt;**
+### Using the `SetDataViewsBuilder()` Method
 
-Sets the collections data views builder which allows you to define the data views dynamically at run time.
+Sets the collection's data views builder, allowing you to define data views dynamically at runtime.
+
+#### Method Syntax
+
+```cs
+SetDataViewsBuilder<TDataViewsBuilder>() : CollectionConfigBuilder<TEntityType>
+```
+
+#### Example
 
 ````csharp
-// Example
 collectionConfig.SetDataViewsBuilder<PersonDataViewsBuilder>();
 ````
 
-### **SetDataViewsBuilder(Type dataViewsBuilderType) : CollectionConfigBuilder&lt;TEntityType&gt;**
+### Using the `SetDataViewsBuilder(Type)` Method
+
+Sets the collection's data views builder, allowing you to define data views dynamically at runtime.
+
+#### Method Syntax
 
-Sets the collections data views builder which allows you to define the data views dynamically at run time.
+```cs
+SetDataViewsBuilder(Type dataViewsBuilderType) : CollectionConfigBuilder<TEntityType>
+```
+
+#### Example
 
 ````csharp
-// Example
 collectionConfig.SetDataViewsBuilder(typeof(PersonDataViewsBuilder));
 ````
 
-### **SetDataViewsBuilder(DataViewsBuilder&lt;TEntityType&gt; dataViewsBuilder) : CollectionConfigBuilder&lt;TEntityType&gt;**
+### Using the `SetDataViewsBuilder(DataViewsBuilder<TEntityType>)` Method
+
+Sets the collection's data views builder, allowing you to define data views dynamically at runtime.
 
-Sets the collections data views builder which allows you to define the data views dynamically at run time.
+#### Method Syntax
+
+```cs
+SetDataViewsBuilder(DataViewsBuilder<TEntityType> dataViewsBuilder) : CollectionConfigBuilder<TEntityType>
+```
+
+#### Example
 
 ````csharp
-// Example
 collectionConfig.SetDataViewsBuilder(new PersonDataViewsBuilder());
 ````

15/umbraco-ui-builder/filtering/data-views.md

@@ -1,31 +1,45 @@
 ---
-description: Configuring data views in Umbraco UI Builder, the backoffice UI builder for Umbraco.
+description: Learn how to configure data views in Umbraco UI Builder.
 ---
 
 # Data Views
 
-Data views allow you to define multiple, pre-filtered views of the same data source. This can be useful when entities exist in different states and you want a way to toggle between them.
+Data views allow you to define multiple pre-filtered views of the same data source. This is useful when entities exist in different states and you need a way to toggle between them.
 
 ![Data Views](../images/data_views.png)
 
-## Defining data views
+## Defining Data Views
 
-Data views are defined via the [collections](../collections/overview.md) configuration.
+Data views are defined via the [Collections](../collections/overview.md) settings.
 
-### **AddDataView(string name, Lambda whereClauseExpression) : CollectionConfigBuilder<TEntityType>**
+### Using the `AddDataView()` Method
 
-Adds a data view with the given name and **where clause** filter expression. Expression must be a `boolean` expression.
+Creates a data view with the specified name and a where clause filter expression. The expression must return a `boolean` value.
+
+#### Method Syntax
+
+```cs
+AddDataView(string name, Lambda whereClauseExpression) : CollectionConfigBuilder<TEntityType>
+```
+
+#### Example
 
 ````csharp
-// Example
 collectionConfig.AddDataView("Active", p => p.IsActive);
 ````
 
-### **AddDataView(string group, string name, Lambda whereClauseExpression) : CollectionConfigBuilder&lt;TEntityType&gt;**
+### Using the `AddDataView()` Method with Group
+
+Creates a data view within a specified group, using a where clause filter expression. The expression must return a  `boolean` value.
+
+#### Method Syntax
+
+```cs
+AddDataView(string group, string name, Lambda whereClauseExpression) : CollectionConfigBuilder<TEntityType>
+```
 
-Adds a data view with the given group, name and **where clause** filter expression. Expression must be a `boolean` expression.
+#### Example
 
 ````csharp
-// Example
 collectionConfig.AddDataView("Status", "Active", p => p.IsActive);
 ````

15/umbraco-ui-builder/filtering/filterable-properties.md

@@ -1,74 +1,126 @@
 ---
-description: Configuring filterable properties in Umbraco UI Builder, the backoffice UI builder for Umbraco.
+description: Learn how to configure filterable properties in Umbraco UI Builder.
 ---
 
 # Filterable Properties
 
-Umbraco UI Builder can dynamically build a filter dialog choosing appropriate editor views for you based on a basic property configuration. Properties of a number or date types will become range pickers and enums. Properties with options defined will become select/checkbox lists and all other properties will become text input filters.
+Umbraco UI Builder dynamically constructs a filter dialog by choosing appropriate editor views based on basic property configurations. Properties of numeric or date types become range pickers, enums become select/checkbox lists, and other properties are text input filters.
 
 ![Filterable Properties](../images/filterable_properties.png)
 
-## Defining filterable properties
+## Defining Filterable Properties
 
-Defining filterable properties is controlled via the [collections](../collections/overview.md) configuration.
+Defining filterable properties is controlled via the [Collections](../collections/overview.md) settings.
 
-### **AddFilterableProperty(Lambda filterablePropertyExpression, Lambda filterConfig = null) : CollectionConfigBuilder<TEntityType>**
+### Using the `AddFilterableProperty()` Method
 
-Adds the given property to the filterable properties collection.
+Adds a given property to the filterable properties collection.
+
+#### Method Syntax
+
+```cs
+AddFilterableProperty(Lambda filterablePropertyExpression, Lambda filterConfig = null) : CollectionConfigBuilder<TEntityType>
+```
+
+#### Example
 
 ````csharp
-// Example
 collectionConfig.AddFilterableProperty(p => p.FirstName, filterConfig => filterConfig 
     // ...
 );
 ````
 
-## Changing the label of a filterable property
+## Changing the Label of a Filterable Property
+
+### Using the `SetLabel()` Method
+
+Sets the label for the filterable property.
+
+#### Method Syntax
 
-### **SetLabel(string label) : FilterablePropertyConfigBuilder&lt;TEntityType, TValueType&gt;**
+```cs
+SetLabel(string label) : FilterablePropertyConfigBuilder<TEntityType, TValueType>
+```
+
+#### Example
 
 ````csharp
-// Example
 filterConfig.SetLabel("First Name");
 ````
 
-## Adding a description to a filterable property
+## Adding a Description to a Filterable Property
+
+### Using the `SetDescription()` Method
+
+Sets a description for the filterable property.
 
-### **SetDescription(string description) : FilterablePropertyConfigBuilder&lt;TEntityType, TValueType&gt;**
+#### Method Syntax
+
+```cs
+SetDescription(string description) : FilterablePropertyConfigBuilder<TEntityType, TValueType>
+```
+
+#### Example
 
 ````csharp
-// Example
 filterConfig.SetDescription("The first name of the person");
 ````
 
-## Defining basic options for a filterable property
+## Defining Basic Options for a Filterable Property
+
+### Using the `SetOptions()` Method
 
-### **SetOptions(IDictionary&lt;TValueType, string&gt; options) : FilterablePropertyConfigBuilder&lt;TEntityType, TValueType&gt;**
+Defines basic options for a filterable property.
+
+#### Method Syntax
+
+```cs
+SetOptions(IDictionary<TValueType, string> options) : FilterablePropertyConfigBuilder<TEntityType, TValueType>
+```
+
+#### Example
 
 ````csharp
-// Example
 filterConfig.SetOptions(new Dictionary<string, string> {
     { "Option1", "Option One" },
     { "Option2", "Option Two" }
 });
 ````
 
-## Defining options with custom compare clauses for a filterable property
+## Defining Options with Custom Compare Clauses for a Filterable Property
+
+### Using the `AddOption()` Method
+
+Defines options with custom comparison clauses for a filterable property.
+
+#### Method Syntax
 
-### **AddOption(object key, string label, Lambda compareExpression) : FilterablePropertyConfigBuilder&lt;TEntityType, TValueType&gt;**
+```cs
+AddOption(object key, string label, Lambda compareExpression) : FilterablePropertyConfigBuilder<TEntityType, TValueType>
+```
+
+#### Example
 
 ````csharp
-// Example
 filterConfig.AddOption("Option1", "Option One", (val) => val != "Option Two");
 ````
 
-## Configuring the mode of a filterable property
+## Configuring the Mode of a Filterable Property
+
+For filterable properties with options, you can configure whether the options should allow multiple or single selections.
+
+### Using the `SetMode()` Method
+
+Configures the mode of a filterable property (multiple or single choice).
+
+#### Method Syntax
 
-For filterable properties with options you can configure whether the options should be multiple or single choice.
+```cs
+SetMode(FilterMode mode) : FilterablePropertyConfigBuilder<TEntityType, TValueType>
+```
 
-### **SetMode(FilterMode mode) : FilterablePropertyConfigBuilder&lt;TEntityType, TValueType&gt;**
+#### Example
 
 ````csharp
-// Example
 filterConfig.SetMode(FilterMode.MultipleChoice);
 ````

15/umbraco-ui-builder/filtering/global-filters.md

@@ -1,20 +1,27 @@
 ---
-description: Configuring a global filter in Umbraco UI Builder, the backoffice UI builder for Umbraco.
+description: Learn how to configure a global filter in Umbraco UI Builder.
 ---
 
 # Global Filters
 
-If you want to work with a subset of data within a given collection then this is where the global filters come in handy. These allow you to define a filter to apply to all queries for a given collection.
+Use global filters to work with a specific subset of data within a collection. These filters apply to all queries for a given collection.
 
-## Applying a global filter
+## Applying a Global Filter
 
-Applying a global filter is controlled via the [collections](../collections/overview.md) configuration.
+Configure global filters in the [Collections](../collections/overview.md) settings.
 
-### **SetFilter(Lambda whereClauseExpression) : CollectionConfigBuilder<TEntityType>**
+### Using the `SetFilter()` Method
 
-Sets the filter **where clause** expression. Expression must be a `boolean` expression.
+Defines a filter using a **where clause** expression. The expression must return a `boolean` value.
+
+#### Method Syntax
+
+```cs
+SetFilter(Lambda whereClauseExpression) : CollectionConfigBuilder<TEntityType>
+```
+
+#### Example
 
 ````csharp
-// Example
 collectionConfig.SetFilter(p => p.Current);
 ````

15/umbraco-ui-builder/filtering/overview.md

@@ -1,10 +1,10 @@
 ---
-description: Configuring filtering in Umbraco UI Builder, the backoffice UI builder for Umbraco.
+description: Learn how to configure filtering in Umbraco UI Builder.
 ---
 
 # Filtering
 
-Beyond [searching](../searching/overview.md) there might be times when you need to be able to create specific views of a collection's data. To help with this Umbraco UI Builder has different filtering mechanisms available.
+In addition to [Searching](../searching/overview.md), you may need to create specific views of a collection's data. Umbraco UI Builder provides multiple filtering mechanisms to help with this.
 
 ![Filterable Properties](../images/filterable_properties.png)