Readme.md improvements (#7)

* Readme.md improved

* Readme.md inconsistencies fixed.

Author: damir-usmanov

README.md

@@ -6,14 +6,13 @@
 
 ## Overview
 
-SoftwareOne.Rql is a high-performance implementation of [Resource Query Language (RQL)](https://docs.platform.softwareone.com/developer-resources/rest-api/resource-query-language) for .NET applications. It enables API consumers to efficiently filter, sort, and paginate data with an intuitive and expressive syntax, delivering precise data retrieval capabilities.
+Mpt.Rql is a high-performance implementation of [Resource Query Language (RQL)](https://docs.platform.softwareone.com/developer-resources/rest-api/resource-query-language) for .NET applications. It enables API consumers to efficiently filter, sort, and paginate data with an intuitive and expressive syntax, delivering precise data retrieval capabilities.
 
 ## Features
 
-- **Advanced Filtering** - Support for complex logical expressions (AND, OR, NOT)
-- **Dynamic Sorting** - Multiple fields with ascending/descending options
-- **Pagination** - Skip and limit results for efficient data loading
-- **Field Selection** - Return only required fields to minimize payload size
+- **Filtering** - Support for complex logical expressions
+- **Sorting** - Multiple fields with ascending/descending options
+- **Projections** - Return only required fields to minimize payload size
 - **LINQ Integration** - Seamless integration with Entity Framework and other LINQ providers
 - **Validation** - Comprehensive error handling and input validation
 - **Performance Optimized** - Efficient query processing for minimal overhead
@@ -42,6 +41,77 @@ public void ConfigureServices(IServiceCollection services)
 }
 ```
 
+### Applying RQL to IQueryable<>
+```csharp
+public class UserQueryBuilder(IRqlQueryable<User> rql)
+{
+    public IQueryable<User> GetUsersOlderThan(IQueryable<User> sourceQuery, int age)
+    {
+        var request = new RqlRequest
+        {
+            Filter = $"gt(age,{age})",              // Age must be greater than age specified
+            Order = "-age",                         // Order by age desc
+            Select = "id,name"                      // Select id and name
+        };
+
+        var response = rql.Transform(sourceQuery, request);
+
+        if (response.IsSuccess)
+            return response.Query;                  // Return transformed query
+
+        response.Errors.ForEach(t => { });          // Iterate through transformation errors (optional)
+
+        Console.WriteLine(response.Graph.Print())   // Visualize the decision graph (optional)
+    }
+}
+```
+
+## Using RQL mapping
+In many projects, developers prefer to keep database entities separate from data transfer objects (DTOs), especially when their structures differ. To support this approach, Mpt.Rql includes built-in mapping functionality, which is enabled by default and relies on name-based matching. For more advanced scenarios, custom mappings can also be defined manually 
+
+### Configure RQL
+```csharp
+public void ConfigureServices(IServiceCollection services)
+{
+    services.AddRql(options =>
+    {
+        // Instruct RQL to look for mappers in specific asembly 
+        options.ScanForMappers(typeof(Program).Assembly); 
+    });
+}
+```
+
+### Specify mapping
+```csharp
+internal class UserMapper : IRqlMapper<DbUser, User>
+{
+    public void MapEntity(IRqlMapperContext<DbUser, User> context)
+    {
+        context
+        .MapStatic(t => t.Id, t => t.UserId)
+        .MapStatic(t => t.Age, t => t.AgeInYears);
+    }
+}
+```
+
+### Apply RQL
+```csharp
+public class UserQueryBuilder(IRqlQueryable<DbUser, User> rql)
+{
+    public IQueryable<User> GetUsersOlderThan(IQueryable<DbUser> sourceQuery, int age)
+    {
+        var request = new RqlRequest
+        {
+            Filter = $"gt(age,{age})",          // Age must be greater than age specified
+            Order = "-age",                     // Order by age desc
+            Select = "id,name"                  // Select id and name
+        };
+
+        return rql.Transform(sourceQuery, request).Query;
+    }
+}
+```
+
 ## Contributing
 
 We welcome contributions to enhance the library. Please see our Contributing Guide for details: