Updated articles

Author: eshanrnh

15/umbraco-ui-builder/advanced/encrypted-properties.md

@@ -1,22 +1,29 @@
 ---
-description: Configuring encrypted properties in Umbraco UI Builder, the backoffice UI builder for Umbraco.
+description: Configuring and using encrypted properties in Umbraco UI Builder to securely store sensitive data.
 ---
 
 # Encrypted Properties
 
-If needed to collect sensitive information in a collection but don't want to persist in a plain text format to the data storage mechanism. Umbraco UI Builder can help with this by allowing you to define properties as encrypted. After which any time the value is persisted or retrieved from persistence, Umbraco UI Builder will automatically encrypt and decrypt the value.
+Umbraco UI Builder allows encrypting properties to store sensitive information securely. When a property is marked as encrypted, its value is automatically encrypted before storage and decrypted upon retrieval.
 
 {% hint style="info" %}
-Umbraco UI Builder uses the `IDataProtectionProvider` instance registered in the DI container to perform its encryption/decryption. If you need to change the encryption algorithm, you should replace the `IDataProtectionProvider` instance in the DI container.
+Umbraco UI Builder uses the `IDataProtectionProvider` instance registered in the DI container for encryption and decryption. To modify the encryption algorithm, replace the `IDataProtectionProvider` instance in the DI container.
 {% endhint %}
 
-## Defining encrypted properties
+## Defining Encrypted Properties
 
-### **AddEncryptedProperty(Lambda encryptedPropertyExpression) : CollectionConfigBuilder<TEntityType>**
+### Using the `AddEncryptedProperty()` Method
 
-Adds the given property to the encrypted properties collection. Property must be of type `String`. When set, the property will be encrypted/decrypted on write/read respectively.
+Encrypts the specified property. The property must be of type `String`. The value is encrypted before storage and decrypted when retrieved.
+
+#### Method Syntax
+
+```csharp
+AddEncryptedProperty(Lambda encryptedPropertyExpression) : CollectionConfigBuilder<TEntityType>
+```
+
+#### Example
 
 ````csharp
-// Example
 collectionConfig.AddEncryptedProperty(p => p.Secret);
 ````

15/umbraco-ui-builder/advanced/repositories.md

@@ -1,14 +1,14 @@
 ---
-description: Configuring repositories in Umbraco UI Builder, the backoffice UI builder for Umbraco.
+description: Configure repositories in Umbraco UI Builder.
 ---
 
 # Repositories
 
-Repositories are used by Umbraco UI Builder to access the entity data stores. By default, collections will use a generic built-in NPoco repository. However, you can define your own repository implementation should you wish to store your entities via an alternative strategy.
+Repositories in Umbraco UI Builder manage entity data storage. By default, collections use a built-in NPoco repository. To use a different storage strategy, define a custom repository implementation.
 
-## Defining a repository
+## Defining a Repository
 
-To define a repository create a class that inherits from the base class `Repository<TEntity, TId>` and implements all of its abstract methods.
+Create a class that inherits from `Repository<TEntity, TId>` and implements all abstract methods.
 
 ````csharp
 // Example
@@ -58,39 +58,62 @@ public class PersonRepository : Repository<Person, int> {
 }
 ````
 
-**Note:** For all `Impl` methods there are public alternatives without the `Impl` suffix. However, there are separate implementation methods in order to ensure all repositories fire the relevant Umbraco UI Builder events. This is whether triggered via the Umbraco UI Builder's UI or not.
+{% hint style="info" %}
+`Impl` methods have public alternatives without the suffix. Separate implementation methods ensure repositories trigger Umbraco UI Builder events, whether actions originate from the UI or not.
+{% endhint %}
 
-## Changing the repository implementation of a collection
+## Changing the Repository Implementation of a Collection
 
-### **SetRepositoryType&lt;TRepositoryType&gt;() : CollectionConfigBuilder&lt;TEntityType&gt;**
+### Using the `SetRepositoryType()` Method
 
-Sets the repository type to the given type for the current collection.
+Assign a custom repository type to a collection.
+
+#### Method Syntax
+
+```cs
+SetRepositoryType<TRepositoryType>() : CollectionConfigBuilder<TEntityType>
+```
+
+#### Example
 
 ````csharp
-// Example
 collectionConfig.SetRepositoryType<PersonRepositoryType>();
 ````
 
-### **SetRepositoryType(Type repositoryType) : CollectionConfigBuilder&lt;TEntityType&gt;**
+### Using the `SetRepositoryType(Type repositoryType)` Method
 
-Sets the repository type to the given type for the current collection.
+Sets the repository type dynamically to the given type for the current collection.
+
+#### Method Syntax
+
+```cs
+SetRepositoryType(Type repositoryType) : CollectionConfigBuilder<TEntityType>
+```
+
+#### Example
 
 ````csharp
-// Example
 collectionConfig.SetRepositoryType(typeof(PersonRepositoryType));
 ````
 
-## Accessing a repository in code
+## Accessing a Repository in Code
 
 To help with accessing a repository (default or custom) Umbraco UI Builder has an `IRepositoryFactory` you can inject into your code base. This includes a couple of factory methods to create the repository instances for you.
 Repositories should only be created via the repository factory as there are some injected dependencies that can only be resolved by Umbraco UI Builder.
 
-### **IRepositoryFactory.GetRepository&lt;TEntity, TId&gt;() : Repository&lt;TEntity, TId&gt;**
+### Using the `GetRepository<TEntity, TId>()` Method
 
 Creates a repository for the given entity type. Umbraco UI Builder will search the configuration for the first section/collection with a configuration for the given entity type. Then it will use that as a repository configuration.
 
+#### Method Syntax
+
+```cs
+IRepositoryFactory.GetRepository<TEntity, TId>() : Repository<TEntity, TId>
+```
+
+#### Example
+
 ````csharp
-// Example
 public class MyController : Controller
 {
     private readonly Repository<Person, int> _repo;
@@ -102,12 +125,19 @@ public class MyController : Controller
 }
 ````
 
-### **IRepositoryFactory.GetRepository&lt;TEntity, TId&gt;(string collectionAlias) : Repository&lt;TEntity, TId&gt;**
+### Using the `GetRepository<TEntity, TId>(string collectionAlias)` Method
 
 Creates a repository for the given entity type from the collection with the given alias.
 
+#### Method Syntax
+
+```cs
+IRepositoryFactory.GetRepository<TEntity, TId>(string collectionAlias) : Repository<TEntity, TId>
+```
+
+#### Example
+
 ````csharp
-// Example
 public class MyController : Controller
 {
     private readonly Repository<Person, int> _repo;

15/umbraco-ui-builder/advanced/value-mappers.md

@@ -1,19 +1,20 @@
 ---
-description: Configuring value mappers in Umbraco UI Builder, the backoffice UI builder for Umbraco.
+description: Configuring value mappers in Umbraco UI Builder to modify how data is stored and retrieved.
 ---
 
 # Value Mappers
 
-A value mapper is an Umbraco UI Builder helper class that sits between the editor UI and the database. It also lets you tweak the stored value of a field. By default Umbraco UI Builder will save a datatype value as it would be stored in Umbraco. Value mappers let you change this.
+Value mappers in Umbraco UI Builder act as intermediaries between the editor UI and the database, allowing customization of stored field values. By default, Umbraco UI Builder saves data as it would be stored in Umbraco, but value mappers enable modifications.
 
-When Umbraco UI Builder resolves a value mapper it will attempt to do so from the global DI container. This means you can inject any dependencies that you require for your mapper. 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 value mapper, Umbraco UI Builder first checks the global DI container. If no type is defined, it manually instantiates a new instance.
 
-## Defining a value mapper
+## Defining a Value Mapper
 
-To define a mapper create a class that inherits from the base class `ValueMapper` and implements the methods `EditorToModel` and `ModelToEditor`.
+To define a mapper, create a class that inherits from the base class `ValueMapper` and implements the `EditorToModel` and `ModelToEditor` methods.
+
+### Example
 
 ````csharp
-// Example
 public class MyValueMapper : ValueMapper
 {
     public override object EditorToModel(object input)
@@ -30,33 +31,54 @@ public class MyValueMapper : ValueMapper
 }
 ````
 
-## Setting a field value mapper
+## Setting a Field Value Mapper
 
 Value mappers are defined as part of a collection editor field configuration.
 
-### **SetValueMapper<TMapperType>() : EditorFieldConfigBuilder<TEntityType, TValueType>**
+### Using the `SetValueMapper()` Method
 
 Set the value mapper for the current field.
 
+#### Method Syntax
+
+```csharp
+SetValueMapper<TMapperType>() : EditorFieldConfigBuilder<TEntityType, TValueType>
+```
+
+#### Example
+
 ````csharp
-// Example
 fieldConfig.SetValueMapper<MyValueMapper>();
 ````
 
-### **SetValueMapper(Type mapperType) : EditorFieldConfigBuilder&lt;TEntityType, TValueType&gt;**
+### Using the `SetValueMapper(Type mapperType)` Method
 
-Set the value mapper for the current field.
+Set the value mapper for the current field using a type reference.
+
+#### Method Syntax
+
+```csharp
+SetValueMapper(Type mapperType) : EditorFieldConfigBuilder<TEntityType, TValueType>
+```
+
+#### Example
 
 ````csharp
-// Example
 fieldConfig.SetValueMapper(typeof(MyValueMapper));
 ````
 
-### **SetValueMapper(Mapper mapper) : EditorFieldConfigBuilder&lt;TEntityType, TValueType&gt;**
+### Using the `SetValueMapper(Mapper mapper)` Method
 
-Set the value mapper for the current field.
+Set the value mapper for the current field using an instance.
+
+#### Method Syntax
+
+```csharp
+SetValueMapper(Mapper mapper) : EditorFieldConfigBuilder<TEntityType, TValueType>
+```
+
+#### Example
 
 ````csharp
-// Example
 fieldConfig.SetValueMapper(new MyValueMapper());
 ````