Update README.md

Author: holomodular-support

README.md

@@ -2,35 +2,42 @@
 
 [![NuGet version](https://badge.fury.io/nu/ServiceQuery.svg)](https://badge.fury.io/nu/ServiceQuery)
 ![badge](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/holomodular-support/5a0fab9a9341bb94e27da49a1e89fd03/raw/servicequery-codecoverage.json)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![License: MIT](https://img.shields.io/badge/License-MIT-389DA0.svg)](https://opensource.org/licenses/MIT)
 
-# ServiceQuery Allows Querying Data Over REST APIs
-ServiceQuery, https://ServiceQuery.com, is an open-source library that allows dynamically querying database information over REST APIs. Similar to how OData and GraphQL work, it leverages the power of an expressions builder and a simple model that is capable of serializing query instructions over service boundaries. It supports numerous popular relational (SQL) and document (NoSQL) database engines that expose an IQueryable interface. ServiceQuery builds LINQ expressions using individually mapped functions and parsed data that eliminates injection attacks, so querying your data is safe and secure. This library provides clients and front end applications unprecedented queryability using a standardized endpoint supporting polyglot data access. 
+# ServiceQuery: Dynamic Data Querying Over REST APIs
+## Overview
+Welcome to [ServiceQuery](https://ServiceQuery.com), the open-source library designed to revolutionize your data querying over REST APIs. Similar to OData and GraphQL, ServiceQuery harnesses the power of an expression builder and a straightforward model to serialize query instructions across service boundaries. It seamlessly supports a wide array of popular relational (SQL) and document (NoSQL) database engines, ensuring secure and efficient data querying by eliminating injection attacks. With ServiceQuery, your clients and front-end applications gain unprecedented querying capabilities through a standardized endpoint supporting polyglot data access. 
 
-# Installation Instructions
-Install the NuGet Package <b>ServiceQuery</b>
+## Get Started
+### Installation is simple:
+Install the NuGet Package **ServiceQuery**
 
-# Examples
-We have numerous examples built using the most popular database storage providers, such as Azure Data Tables, Cosmos DB, MongoDB, MySQL, SQLite, SQL Server, PostgreSQL, Oracle and more! 
-View all our examples in the [examples](https://github.com/holomodular/ServiceQuery/blob/main/examples) folder in this project.
+## Why ServiceQuery?
+* **Versatile:** Supports numerous database engines including Azure Data Tables, Cosmos DB, MongoDB, MySQL, SQLite, SQL Server, PostgreSQL, Oracle, and more.
+* **Secure:** Builds LINQ expressions using individually mapped functions and parsed data, eliminating injection attacks.
+* **Powerful:** Provides clients and front-end applications with unprecedented querying capabilities.
 
-# Feedback
-We want to hear from our users. Please feel free to post any issues or questions on our discussion board. You can star our repository or you can also reach us at: Support@HoloModular.com
+## Examples
+Explore our [examples folder](https://github.com/holomodular/ServiceQuery/blob/main/examples/V2) for detailed implementations using the most popular database storage providers.
 
-# Simple Example - Dynamic Querying Using Javascript
-Modeled based on LINQ, you create a simple request object that is sent over a REST API endpoint to your web server. Make sure to include the following [ServiceQuery.js](https://github.com/holomodular/ServiceQuery/blob/main/src/V2/javascript/servicequery.js) javascript file to quickly build request queries in javascript.
+## We Value Your Feedback
+Join our discussion board to post any questions or issues. Don't forget to star our repository. For direct support, reach us at: Support@HoloModular.com
+
+## Dynamic Querying Made Easy
+Here's how you can dynamically query data using JavaScript:
+Make sure to include the following [ServiceQuery.js](https://github.com/holomodular/ServiceQuery/blob/main/src/V2/javascript/servicequery.js) javascript file to quickly build request queries in javascript.
 ```javascript
 <script src="/js/servicequery.js"></script>
 <script type="text/javascript">
 
   function GetById() {
 
-    // Build the request
+    // Build the request where id = 123
     var request = new ServiceQueryRequestBuilder().IsEqual("Id","123").Build();
 
-    // Send request to REST API
+    // Send ajax request to REST Controller
     $.ajax({
-        url: '/api/MyAPI/ExampleServiceQuery',
+        url: '/ExampleServiceQuery',
         data: JSON.stringify(request),
         type: "POST",
         dataType: 'json',
@@ -44,8 +51,7 @@ Modeled based on LINQ, you create a simple request object that is sent over a RE
   }
 </script>
 ```
-On the web server, the request is safely converted into IQueryable expressions that can be executed against several different database engines.
-The following exposes a REST API POST method that the client will call.
+On the server side, convert the request into IQueryable expressions and return the result:
 ```csharp
 using ServiceQuery;
 
@@ -58,14 +64,15 @@ public ServiceQueryResponse<ExampleTable> ExampleServiceQuery(ServiceQueryReques
 }
 ```
 
-# Documentation
-Documentation is located on our website at http://ServiceQuery.com as well as a simplified version below. The website also contains tables for supported data types and operations by .NET Framework version and database engine.
+## Documentation
+Comprehensive cocumentation is available on our website at http://ServiceQuery.com including tables for supported data types and operations by .NET Framework version and database engine.
 
 ## ServiceQuery.AzureDataTables
-AzureDataTables does not support several things out of the box, such as aggregates, string comparisons and ordering (solved by downloading all records). We have built a companion NuGet package <b>ServiceQuery.AzureDataTables</b> that provides workarounds to these limitations so you can use all standard operations and execute the request in one line of code. See our example projects for more information.
+Azure Data Tables has certain limitations, like lack of support for aggregate functions, string comparisons and ordering. 
+Our companion NuGet package <b>ServiceQuery.AzureDataTables</b> provides a solution to these limitations, allowing you to use standard operations and execute requests seamlessly. The solution is to download all records and then perform the query using an internal list. See our example project for more information.
 
 ## Building and Executing a Query
-Building a query is accomplished using the ServiceQueryRequestBuilder object to create the request.
+Construct queries using the ServiceQueryRequestBuilder object:
 ```csharp
 using ServiceQuery;
 
@@ -82,14 +89,14 @@ public void Example()
 ```
 
 ## Supported Operations
-Aggregate Functions
+### Aggregate Functions
 * Average
 * Count
 * Maximum
 * Minimum
 * Sum
 
-Comparison Functions
+### Comparison Functions
 * Between
 * Equal
 * Not Equal
@@ -100,31 +107,31 @@ Comparison Functions
 * In Set
 * Not In Set
 
-Comparison Functions (string)
+### Comparison Functions (string)
 * Contains
 * StartsWith
 * EndsWith
 
-Grouping Functions
+### Grouping Functions
 * And
 * Or
 * Begin
 * End
 
-Nullability Functions
+### Nullability Functions
 * Null
 * Not Null
 
-Paging Functions
+### Paging Functions
 * Page Number
 * Page Size
 * Include Count
 
-Selecting Functions
+### Selecting Functions
 * Distinct
 * Select
 
-Sorting Functions
+### Sorting Functions
 * Sort Ascending
 * Sort Descending
 
@@ -196,54 +203,26 @@ If you are using javascript, make sure to download the [ServiceQuery.js](https:/
 ```
 
 ## ServiceQuery Options
-We currently provide the following server-side options when processing queries.
+Customize server-side query processing with ServiceQueryOptions object:
 ```csharp
     public class ServiceQueryOptions
     {
-        /// <summary>
-        /// Dictionary list of property name mappings.
-        /// Exposed Class -> Internal Class
-        /// Default will use all queryable class property names
-        /// </summary>
         public Dictionary<string, string> PropertyNameMappings { get; set; }
-
-        /// <summary>
-        /// Determine whether property names must be case sensitive or throw an exception.
-        /// Default is false.
-        /// </summary>
         public bool PropertyNameCaseSensitive { get; set; }
-        
-	/// <summary>
-	/// Determine if missing BEGIN/END/AND/OR expressions throw an exception
-	/// or try to add them missing ones automatiically.
-	/// </summary>
         public bool AllowMissingExpressions { get; set; }
     }
 ```
 
 ## Advanced Usage Scenarios
-There are many benefits to being able to manipulate queries before they are executed. You could:
-
-* Restrict properties by user roles
-
-When receiving a query, you can use the ServiceQueryOptions to change the list of mapped properties based on the user's security role. If a user specifies a property that is not mapped, such as SSN property, an exception is thrown.
-
-Note: You should restrict properties from select, where and orderby filters so that no information can be obtained, filtered, ordered or gleaned in anyway by its usage.
-
-* Sharding data
-
-When receiving a query, you can add expressions on to the query to make sure that it is only performed against a data segment that you specify, for instance a CustomerKey.
-This would be in the format: 
 
-**( originalquery ) AND CustomerKey = 123**
+### Manipulate queries before executing them
+Add to, change or remove filters from incoming queries for business reasons.
 
-To accomplish this on a ServiceQueryRequest object, perform the following operations:
-1) Add a BEGIN expressions at the first index of the filters
-2) Add an END expression to the end of the list
-3) Add an AND expression to the end of the list
-4) Add an ISEQUAL for property CustomerKey and value 123
+### Restrict properties by user roles
+Adjust property mappings based on user role for security.
 
-If the user doesn't pass any where filters, skip steps 1-3. The library will validate queries, ensuring begin and end expressions, their directions and counts match, ensuring users can't craft malicious queries to circumvent this, otherwise an exception is thrown.
+### Sharding data
+Add expressions to queries to target specific data segments, ensuring efficient data retrieval and enhanced security.
 
-# About
-I am a business executive and software architect with over 26 years professional experience. You can reach me via www.linkedin.com/in/danlogsdon or https://HoloModular.com
+## About
+I am a business executive and software architect with 25+ years professional experience. You can reach me via www.linkedin.com/in/danlogsdon or visit https://HoloModular.com