Update documentation as per review feedback

README.md

@@ -7,8 +7,7 @@
 [![License](https://img.shields.io/badge/license-Apache--2.0-purple.svg?style=flat)](LICENSE.txt)
 [![Status](https://img.shields.io/badge/status-alpha-yellow.svg?style=flat)](./readme.md)
 
-The Hasura Elasticsearch Connector allows for connecting to a Elasticsearch search engine, giving you an instant
-GraphQL API on top of your Elasticsearch data.
+With this connector, Hasura allows you to instantly create a real-time GraphQL API on top of your documents in Elasticsearch. This connector supports Elasticsearch functionalities listed in the table below, allowing for efficient and scalable data operations. Additionally, you will benefit from all the powerful features of Hasura’s Data Delivery Network (DDN) platform, including query pushdown capabilities that delegate all query operations to the Elasticsearch, thereby enhancing query optimization and performance.
 
 This connector is built using the [Go Data Connector SDK](https://github.com/hasura/ndc-sdk-go) and implements the [Data Connector Spec](https://github.com/hasura/ndc-spec).
 

docs/architecture.md

@@ -6,7 +6,7 @@ The Elasticsearch Connector takes a `QueryRequest`, which contains information a
 
 ### Components
 
-The architecture of the Elasticsearch Connector is composed of three main components:
+The connector has three main components:
 
 1. **prepareElasticsearchQuery**
 2. **Search**
@@ -37,8 +37,8 @@ func prepareElasticsearchQuery(
 Executes the DSL query against Elasticsearch and returns results.
 
 **Functionality:**
-- Execute the query on the Elasticsearch index.
-- Fetch raw search results.
+- Execute queries on the specified Elasticsearch index.
+- Fetch search results.
 
 **API:**
 
@@ -55,8 +55,8 @@ func (e *Client) Search(
 Converts Elasticsearch search results into `QueryResponse`.
 
 **Functionality:**
-- Traverse through each field in the Elasticsearch response.
-- Construct and return the `QueryResponse`, ensuring it aligns with the expected fields.
+- Traverse each field in the Elasticsearch response.
+- Construct and return the QueryResponse, ensuring it conforms to the expected fields.
 
 **API:**