From a39d06b59a891a01e6de4af24b863068a0a68cb7 Mon Sep 17 00:00:00 2001
From: Andreas Motl <andreas.motl@crate.io>
Date: Tue, 12 Sep 2023 10:37:48 +0200
Subject: [PATCH 1/2] [connect/cli] Wording: Remove "CrateDB Server" label

---
 docs/connect/cli.md   | 8 ++++----
 docs/connect/index.md | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/connect/cli.md b/docs/connect/cli.md
index 912498b..4fd18a8 100644
--- a/docs/connect/cli.md
+++ b/docs/connect/cli.md
@@ -31,7 +31,7 @@ working with CrateDB. For more information, see the documentation about [crash].
 
 ::::{tab-set}
 
-:::{tab-item} CrateDB Server and Cloud
+:::{tab-item} CrateDB and CrateDB Cloud
 :sync: server
 
 ```{code-block} shell
@@ -72,7 +72,7 @@ For more information, see the documentation about [psql].
 
 ::::{tab-set}
 
-:::{tab-item} CrateDB Server and Cloud
+:::{tab-item} CrateDB and CrateDB Cloud
 :sync: server
 
 ```{code-block} shell
@@ -111,7 +111,7 @@ For more information, see the documentation about [HTTPie].
 
 ::::{tab-set}
 
-:::{tab-item} CrateDB Server and Cloud
+:::{tab-item} CrateDB and CrateDB Cloud
 :sync: server
 
 ```{code-block} shell
@@ -151,7 +151,7 @@ This example combines it with [jq], a lightweight and flexible command-line JSON
 
 ::::{tab-set}
 
-:::{tab-item} CrateDB Server and Cloud
+:::{tab-item} CrateDB and CrateDB Cloud
 :sync: server
 
 ```{code-block} shell
diff --git a/docs/connect/index.md b/docs/connect/index.md
index 90fa3ce..188135e 100644
--- a/docs/connect/index.md
+++ b/docs/connect/index.md
@@ -16,7 +16,7 @@ needs to be configured with corresponding settings.
 
 ::::::{tab-set}
 
-:::::{tab-item} CrateDB Server and Cloud
+:::::{tab-item} CrateDB and CrateDB Cloud
 
 ::::{grid}
 :margin: 0

From 5a73ea20d62985ef50c5260c1b9acc59323be3fd Mon Sep 17 00:00:00 2001
From: Andreas Motl <andreas.motl@crate.io>
Date: Tue, 12 Sep 2023 10:38:19 +0200
Subject: [PATCH 2/2] [connect/cli] Disambiguate clustername vs. hostname

---
 docs/connect/cli.md | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/docs/connect/cli.md b/docs/connect/cli.md
index 4fd18a8..fc64a56 100644
--- a/docs/connect/cli.md
+++ b/docs/connect/cli.md
@@ -10,8 +10,11 @@ You can use them to quickly validate HTTP and PostgreSQL connectivity to your
 database cluster, or to conduct basic scripting.
 
 Before running the command-line snippets outlined below, please use the correct
-settings instead of the placeholder tokens `<username>`, `<password>`, and
-`<clustername>`.
+settings instead of the placeholder tokens `<hostname>`, `<username>` and
+`<password>`.
+
+When using CrateDB Cloud, `<hostname>` will be something like
+`<clustername>.{aks1,eks1}.region.{azure,aws}.cratedb.net`.
 
 
 (crash)=
@@ -36,7 +39,7 @@ working with CrateDB. For more information, see the documentation about [crash].
 
 ```{code-block} shell
 CRATEPW=<password> \
-    crash --hosts 'https://<clustername>.cratedb.net:4200' --username '<username>' \
+    crash --hosts 'https://<hostname>:4200' --username '<username>' \
     --command "SELECT 42.42;"
 ```
 :::
@@ -77,7 +80,7 @@ For more information, see the documentation about [psql].
 
 ```{code-block} shell
 PGUSER=<username> PGPASSWORD=<password> \
-    psql postgresql://<clustername>.cratedb.net/crate --command "SELECT 42.42;"
+    psql postgresql://<hostname>/crate --command "SELECT 42.42;"
 ```
 :::
 
@@ -115,7 +118,7 @@ For more information, see the documentation about [HTTPie].
 :sync: server
 
 ```{code-block} shell
-http https://<username>:<password>@<clustername>.cratedb.net:4200/_sql?pretty" \
+http https://<username>:<password>@<hostname>:4200/_sql?pretty" \
     stmt="SELECT 42.42;"
 ```
 :::
@@ -156,7 +159,7 @@ This example combines it with [jq], a lightweight and flexible command-line JSON
 
 ```{code-block} shell
 echo '{"stmt": "SELECT 42.42;"}' \
-    | curl "https://<username>:<password>@<clustername>.cratedb.net:4200/_sql?pretty" --silent --data @- | jq
+    | curl "https://<username>:<password>@<hostname>:4200/_sql?pretty" --silent --data @- | jq
 ```
 :::