README: Just a bit of copy-editing

Author: amotl

README.md

@@ -1,39 +1,42 @@
-# CrateDB tableau's connector.
+# CrateDB connector for Tableau
 
 [![CI status](https://github.com/crate/cratedb-tableau-connector/actions/workflows/main.yml/badge.svg)](https://github.com/crate/cratedb-tableau-connector/actions/workflows/main.yml)
 ![GitHub Release](https://img.shields.io/github/v/release/crate/cratedb-tableau-connector)
 ![Static Badge](https://img.shields.io/badge/tdvt_compatibility-95%25-brightgreen?style=flat&logo=cratedb)
 ![Static Badge](https://img.shields.io/badge/CrateDB-5.10.1-brightgreen?style=flat&logo=cratedb)
 
-For simple queries and graphs, you can use the default PostgresSQL connector,
-but for more advance usage SQL compatibility issues and nuanced SQL functionalities get into play,
-we circumvent/fix those limitations with our custom connector.
+## About
 
-## How to use.
+[Tableau] is a visual business intelligence and analytics software platform.
+It expresses data by translating drag-and-drop actions into data queries
+through an intuitive interface.
 
-You will need two things:
+[CrateDB] is a distributed and scalable SQL database for storing and analyzing
+massive amounts of data in near real-time, even with complex queries. It is
+PostgreSQL-compatible, and based on Lucene.
 
-The `postgresql jdbc driver` and the `cratedb` connector..
+## Install
 
-### Get the Postgresql jdbc driver.
+You will need to acquire and install two software artefacts,
+the PostgreSQL JDBC driver, and the CrateDB connector.
 
-Download the driver from [here](https://jdbc.postgresql.org/download/) and put it in:
+### PostgreSQL JDBC driver
+
+Download the driver from the [pgJDBC page] and put it into:
 
 - Windows: `C:\Program Files\Tableau\Drivers`
 - Mac: `~/Library/Tableau/Drivers`
 - Linux: `/opt/tableau/tableau_driver/jdbc` 
 
-The latest PostgreSQL jdbc tested driver is `postgresql-42.7.4.jar`.
-
-The latest CrateDB jdbc tested driver is `cratedb-jdbc-standalone-2.7.0`
+The latest validated PostgreSQL JDBC driver version is `postgresql-42.7.4.jar`.
+The latest validated CrateDB JDBC driver is `cratedb-jdbc-standalone-2.7.0`.
 
-Note: `postgresql-42.7.5.jar` does not seem to work.
+Note: The most recent release `postgresql-42.7.5.jar` is not compatible with CrateDB.
+We are currently working with upstream authors on resolving this regression.
 
-### Get the CrateDB connector.
+### CrateDB connector
 
-You can find the connector in the [release section.](https://github.com/crate/cratedb-tableau-connector/releases)
-
-Put it in: 
+You can find the connector on the [releases page]. Put it into:
 
 #### Tableau Desktop
 
@@ -49,23 +52,59 @@ Put it in:
 - Windows: `C:\Program Files\Tableau\Connectors`
 - Linux: `/opt/tableau/connectors`
 
-For older versions see https://help.tableau.com/current/pro/desktop/en-us/examples_connector_sdk.htm
+For older versions, see [Tableau Connector SDK legacy documentation].
 
-## Disabling signature verification.
 
-The current release of the connector is not signed. This issue is being addressed, but in the meantime, verification can be disabled.
+## Usage
 
-* On _Tableau Desktop_, please use this command-line argument: `-DDisableVerifyConnectorPluginSignature=true`
+### Configure data source
+
+Todo: Add a few words how to actually establish the connection to CrateDB
+after installing the driver and connector?
 
-* On _Tableau Server_, you can disable signature verification by setting `native_api.disable_verify_connector_plugin_signature` to `true` via TSM.
 
-More information can be found [here](https://tableau.github.io/connector-plugin-sdk/docs/run-taco)
+### Signature verification
 
+The current release of the connector is not signed. This issue is being addressed,
+but in the meantime, signature verification can be disabled.
 
-## State of the driver.
+* On _Tableau Desktop_, please use this command-line argument: `-DDisableVerifyConnectorPluginSignature=true`
 
-This custom connector aims to offer the best Tableau experience possible, this is a work in progress since 
-PostgresSQL compatibility is not 100% and is bound to change over time.
+* On _Tableau Server_, you can disable signature verification by setting `native_api.disable_verify_connector_plugin_signature` to `true` via TSM.
 
-We test compatibility issues with Tableau's connector sdk: [TDVT suite](https://tableau.github.io/connector-plugin-sdk/docs/tdvt).
-Progress is tracked in https://github.com/crate/cratedb-tableau-connector/issues/2
+More information can be found on the [Tableau Connector SDK `run-taco` documentation].
+
+
+## Status
+
+The native CrateDB connector for Tableau aims to offer excellent compatibility
+with Tableau's line of products, providing optimal user experience.
+While it does not offer 100% compatibility yet, the connector is pretty close to
+cover Tableau's test suite successfully and completely.
+
+```
+CrateDB version: 5.10.1
+Last update: 20/02/2024
+Pass: 96%
+```
+```
+Test Count: 848 tests
+Passed tests: 807
+Failed tests: 41
+Tests run: 848
+Disabled tests: 0
+Skipped tests: 0
+```
+
+Compatibility is validated using Tableau's Connector SDK, specifically using its [TDVT suite].
+Compatibility progress is tracked in [TABLEAU-2].
+
+
+[CrateDB]: https://cratedb.com/database
+[pgJDBC page]: https://jdbc.postgresql.org/download/
+[releases page]: https://github.com/crate/cratedb-tableau-connector/releases
+[Tableau]: https://www.tableau.com/
+[Tableau Connector SDK legacy documentation]: https://help.tableau.com/current/pro/desktop/en-us/examples_connector_sdk.htm
+[Tableau Connector SDK `run-taco` documentation]: https://tableau.github.io/connector-plugin-sdk/docs/run-taco
+[TABLEAU-2]: https://github.com/crate/cratedb-tableau-connector/issues/2
+[TDVT suite]: https://tableau.github.io/connector-plugin-sdk/docs/tdvt