docs: Updated README

Author: Julien Ruaux

README.adoc

@@ -2,7 +2,7 @@
 :project-owner:      redis-field-engineering
 :project-name:       redis-sql-trino
 :project-group:      com.redis
-:project-version:   0.3.0
+:project-version:    0.3.0
 :name:               Redis SQL Trino
 
 ++++
@@ -20,9 +20,12 @@
 image:https://github.com/{project-owner}/{project-name}/actions/workflows/early-access.yml/badge.svg["Build Status", link="https://github.com/{project-owner}/{project-name}/actions/workflows/early-access.yml"]
 image:https://codecov.io/gh/{project-owner}/{project-name}/branch/master/graph/badge.svg?token={codecov-token}["Coverage", link="https://codecov.io/gh/{project-owner}/{project-name}"]
 
-{name} lets lets you easily integrate with visualization frameworks — like Tableau and SuperSet — and platforms that support JDBC-compatible databases (e.g., Mulesoft). Query support includes SELECT statements across secondary indexes on both Redis hashes & JSON, aggregations (e.g., count, min, max, avg), ordering, and more.
+{name} lets lets you easily integrate with visualization frameworks — like Tableau and SuperSet — and platforms that support JDBC-compatible databases (e.g., Mulesoft).
+Query support includes SELECT statements across secondary indexes on both Redis hashes & JSON, aggregations (e.g., count, min, max, avg), ordering, and more.
 
-Trino is a distributed SQL engine designed to query large data sets across one or more heterogeneous data sources. Though Trino does support a https://trino.io/docs/current/connector/redis.html[Redis OSS connector], this connector is limited to SCAN and subsequent HGET operations, which do not scale well in high-throughput scenarios. However, that is where {name} shines since it can pushdown the entire query to the data atomically which eliminates the waste of many network hops and subsequent operations.
+Trino is a distributed SQL engine designed to query large data sets across one or more heterogeneous data sources.
+Though Trino does support a https://trino.io/docs/current/connector/redis.html[Redis OSS connector], this connector is limited to SCAN and subsequent HGET operations, which do not scale well in high-throughput scenarios.
+However, that is where {name} shines since it can pushdown the entire query to the data atomically which eliminates the waste of many network hops and subsequent operations.
 
 == Table of Contents
 
@@ -36,13 +39,18 @@ Trino is a distributed SQL engine designed to query large data sets across one o
 
 == Background
 
-Redis is an in-memory data store designed to serve data with the fastest possible response times. For this reason, Redis is frequently used for caching OLTP-style application queries and as a serving layer in data pipeline architectures (e.g., lambda architectures, online feature stores, etc.). Redis Stack is an extension to Redis that, among other things, lets you index your data on secondary attributes and then efficiently query it using a custom query language.
+Redis is an in-memory data store designed to serve data with the fastest possible response times.
+For this reason, Redis is frequently used for caching OLTP-style application queries and as a serving layer in data pipeline architectures (e.g., lambda architectures, online feature stores, etc.).
+Redis Stack is an extension to Redis that, among other things, lets you index your data on secondary attributes and then efficiently query it using a custom query language.
 
-We built the {name} connector so that you can query Redis using SQL. This is useful for any application compatible with JDBC. For example, {name} lets you query and visualize your Redis data from Tableau.
+We built the {name} connector so that you can query Redis using SQL.
+This is useful for any application compatible with JDBC.
+For example, {name} lets you query and visualize your Redis data from Tableau.
 
 == Requirements
 
-{name} requires a Redis deployment that includes https://redis.io/docs/stack/search/https://redis.io/docs/stack/search/[RediSearch]. RediSearch is a https://redis.io/docs/reference/modules/[Redis module] that adds querying and secondary indexing to Redis.
+{name} requires a Redis deployment that includes https://redis.io/docs/stack/search/https://redis.io/docs/stack/search/[RediSearch].
+RediSearch is a https://redis.io/docs/reference/modules/[Redis module] that adds querying and secondary indexing to Redis.
 
 Redis deployments that bundle RediSearch include:
 
@@ -52,7 +60,8 @@ Redis deployments that bundle RediSearch include:
 
 == Quick start
 
-To understand how {name} works, it's best to try it for yourself. View the screen recording or follow the steps below:
+To understand how {name} works, it's best to try it for yourself.
+View the screen recording or follow the steps below:
 
 image::https://asciinema.org/a/526185.svg[asciicast,link=https://asciinema.org/a/526185]
 
@@ -69,7 +78,8 @@ Next, use Docker Compose to launch containers for Trino and Redis Stack:
 docker-compose up
 ----
 
-This example uses a small data set describing a collection of beers. To load the data set, you'll need to have https://developer.redis.com/riot/riot-file/index.html[riot-file] installed locally (see the https://developer.redis.com/riot/riot-file/index.html[riot-file] installation instructions).
+This example uses a small data set describing a collection of beers.
+To load the data set, you'll need to have https://developer.redis.com/riot/riot-file/index.html[riot-file] installed locally (see the https://developer.redis.com/riot/riot-file/index.html[riot-file] installation instructions).
 
 Next, use `riot-file` to import the sample data set into Redis:
 [source,console]
@@ -78,20 +88,24 @@ riot-file -h localhost import https://storage.googleapis.com/jrx/beers.json \
   hset --keyspace beer --keys id
 ----
 
-Each beer is represented as a Redis hash. Start the Redis CLI to examine this data. For example, here's how you can view the "Beer Town Brown" record:
+Each beer is represented as a Redis hash.
+Start the Redis CLI to examine this data.
+For example, here's how you can view the "Beer Town Brown" record:
 [source,console]
 ----
 docker exec -it redis /opt/redis-stack/bin/redis-cli
 127.0.0.1:6379> hgetall beer:190
 ----
 
-Next, create an index on the beer data. While still in the Redis CLI, you can create the required index by running the following `FT.CREATE` command:
+Next, create an index on the beer data.
+While still in the Redis CLI, you can create the required index by running the following `FT.CREATE` command:
 [source,console]
 ----
 127.0.0.1:6379> FT.CREATE beers ON HASH PREFIX 1 beer: SCHEMA id TAG SORTABLE brewery_id TAG SORTABLE name TEXT SORTABLE abv NUMERIC SORTABLE descript TEXT style_name TAG SORTABLE cat_name TAG SORTABLE
 ----
 
-Now that you've indexed the data set, you can query it using SQL statements through Trino. Start the Trino CLI:
+Now that you've indexed the data set, you can query it using SQL statements through Trino.
+Start the Trino CLI:
 [source,console]
 ----
 docker exec -it trino trino --catalog redisearch --schema default
@@ -119,28 +133,36 @@ To run {name} in production, you'll need:
 
 === Trino
 
-First, you'll need a working Trino installation. 
+First, you'll need a working Trino installation.
 
-See the https://trino.io/docs/current/installation.html[Trino installation and deplyoment guide] for details. Trino recommends a https://trino.io/docs/current/installation/containers.html[container-based deployment] using your orchestration platform of choice. If you run Kubernetes, see the https://trino.io/docs/current/installation/kubernetes.html[Trino Helm chart].
+See the https://trino.io/docs/current/installation.html[Trino installation and deplyoment guide] for details.
+Trino recommends a https://trino.io/docs/current/installation/containers.html[container-based deployment] using your orchestration platform of choice.
+If you run Kubernetes, see the https://trino.io/docs/current/installation/kubernetes.html[Trino Helm chart].
 
 === {name} Connector
 
-Next, you'll need to install the {name} plugin and configure it. See our documentation for https://{project-owner}.github.io/{project-name}/#redisearch-connector[plugin installation] and https://{project-owner}.github.io/{project-name}/#configuration[plugin configuration].
+Next, you'll need to install the {name} plugin and configure it.
+See our documentation for https://{project-owner}.github.io/{project-name}/#redisearch-connector[plugin installation] and https://{project-owner}.github.io/{project-name}/#configuration[plugin configuration].
 
 === Redis installation
 
-For a self-managed deployment, or for testing locally, install https://redis.io/docs/stack/[Redis Stack] or spin up a free https://redis.com/try-free/[Redis Cloud] instance. If you need a fully-managed, cloud-based deployment of Redis on AWS, GCP, or Azure, see all of the https://redis.com/redis-enterprise-cloud/overview/[Redis Cloud] offerings. For deployment in your own private cloud or data center, consider https://redis.com/redis-enterprise-software/overview/[Redis Enterprise].
+For a self-managed deployment, or for testing locally, install https://redis.io/docs/stack/[Redis Stack] or spin up a free https://redis.com/try-free/[Redis Cloud] instance.
+If you need a fully-managed, cloud-based deployment of Redis on AWS, GCP, or Azure, see all of the https://redis.com/redis-enterprise-cloud/overview/[Redis Cloud] offerings.
+For deployment in your own private cloud or data center, consider https://redis.com/redis-enterprise-software/overview/[Redis Enterprise].
 
 == Usage
 
 The example above uses the https://trino.io/docs/current/client/cli.html[Trino CLI] to access your data.
 
-Most real world applications will use the https://trino.io/docs/current/client/jdbc.html[Trino JDBC driver] to issue queries. See the https://{project-owner}.github.io/{project-name}/#clients[{name}] documentation for details.
+Most real world applications will use the https://trino.io/docs/current/client/jdbc.html[Trino JDBC driver] to issue queries.
+See the https://{project-owner}.github.io/{project-name}/#clients[{name}] documentation for details.
 
 == Support
 
-{name} is supported by Redis, Inc. on a good faith effort basis. To report bugs, request features, or receive assistance, please https://github.com/{project-owner}/{project-name}/issues[file an issue].
+{name} is supported by Redis, Inc. on a good faith effort basis.
+To report bugs, request features, or receive assistance, please https://github.com/{project-owner}/{project-name}/issues[file an issue].
 
 == License
 
-{name} is licensed under the MIT License. Copyright (C) 2023 Redis, Inc.
+{name} is licensed under the MIT License.
+Copyright (C) 2023 Redis, Inc.