Connect: Harmonize sections to use "SSL connection" across the board

Author: amotl

docs/connect/elixir/index.md

@@ -52,12 +52,14 @@ result = Postgrex.query!(conn, "SELECT region, mountain, height FROM sys.summits
 IO.inspect(result)
 ```
 
-:::{rubric} CrateDB Cloud
+:::{rubric} SSL connection
 :::
 
-For connecting to CrateDB Cloud, adjust the `ssl: true` parameter,
+Adjust the `ssl: true` parameter,
 and replace hostname, username, and password with values matching your
 environment.
+
+Also use this variant to connect to CrateDB Cloud.
 ```elixir
 options = [
   hostname: "testcluster.cratedb.net",

docs/connect/go/ksql.md

@@ -74,17 +74,19 @@ func main() {
 }
 ```
 
-:::{rubric} CrateDB Cloud
+:::{rubric} SSL connection
 :::
 
-For connecting to CrateDB Cloud, use `sslmode=require`, and
+Use `sslmode=require`, and
 replace username, password, and hostname with values matching
 your environment.
+
+Also use this variant to connect to CrateDB Cloud.
 ```go
 dbURL := "postgresql://admin:[email protected]:5432/?sslmode=require"
 ```
 
-:::{rubric} Quickstart example
+:::{rubric} Example
 :::
 
 Create the file `example.go` including the synopsis code shared above.

docs/connect/go/pgx.md

@@ -61,12 +61,14 @@ func main() {
 }
 ```
 
-:::{rubric} CrateDB Cloud
+:::{rubric} SSL connection
 :::
 
-For connecting to CrateDB Cloud, use `sslmode=require`, and
+Use `sslmode=require`, and
 replace username, password, and hostname with values matching
 your environment.
+
+Also use this variant to connect to CrateDB Cloud.
 ```go
 conn, _ := pgx.Connect(ctx, "postgresql://admin:[email protected]:5432/?sslmode=require")
 ```

docs/connect/go/pq.md

@@ -41,17 +41,19 @@ func main() {
 }
 ```
 
-:::{rubric} CrateDB Cloud
+:::{rubric} SSL connection
 :::
 
-For connecting to CrateDB Cloud, use `sslmode=require`, and
+Use `sslmode=require`, and
 replace username, password, and hostname with values matching
 your environment.
+
+Also use this variant to connect to CrateDB Cloud.
 ```go
 connStr := "postgresql://admin:[email protected]:5432/?sslmode=require"
 ```
 
-:::{rubric} Quickstart example
+:::{rubric} Example
 :::
 
 Create the file `example.go` including the synopsis code shared above.

docs/connect/java/cratedb-jdbc.md

@@ -61,12 +61,14 @@ void main() throws SQLException {
 }
 ```
 
-:::{rubric} CrateDB Cloud
+:::{rubric} SSL connection
 :::
 
-For connecting to CrateDB Cloud, use the `sslmode=require` parameter,
+Use the `sslmode=require` parameter,
 and replace username, password, and hostname with values matching
 your environment.
+
+Also use this variant to connect to CrateDB Cloud.
 ```java
 properties.put("user", "admin");
 properties.put("password", "password");

docs/connect/java/postgresql-jdbc.md

@@ -61,12 +61,14 @@ void main() throws SQLException {
 }
 ```
 
-:::{rubric} CrateDB Cloud
+:::{rubric} SSL connection
 :::
 
-For connecting to CrateDB Cloud, use the `sslmode=require` parameter,
+Use the `sslmode=require` parameter,
 and replace username, password, and hostname with values matching
 your environment.
+
+Also use this variant to connect to CrateDB Cloud.
 ```java
 properties.put("user", "admin");
 properties.put("password", "password");

docs/connect/odbc/csharp.md

@@ -56,6 +56,18 @@ using (OdbcConnection connection = new OdbcConnection(connection_string))
 }
 ```
 
+:::{rubric} SSL connection
+:::
+
+Use the `Sslmode=require` parameter,
+and replace username, password, and hostname with values matching
+your environment.
+
+Also use this variant to connect to CrateDB Cloud.
+```csharp
+string connection_string = "Driver={PostgreSQL Unicode};Server=testcluster.cratedb.net;Port=5432;Sslmode=require;Uid=admin;Pwd=password";
+```
+
 :::{rubric} Example
 :::
 
@@ -68,16 +80,6 @@ Invoke program.
 dotnet run
 ```
 
-:::{rubric} CrateDB Cloud
-:::
-
-For connecting to CrateDB Cloud, use the `Sslmode=require` parameter,
-and replace username, password, and hostname with values matching
-your environment.
-```csharp
-string connection_string = "Driver={PostgreSQL Unicode};Server=testcluster.cratedb.net;Port=5432;Sslmode=require;Uid=admin;Pwd=password";
-```
-
 
 [.NET Framework Data Provider for ODBC]: https://learn.microsoft.com/en-us/dotnet/framework/data/adonet/data-providers#net-framework-data-provider-for-odbc
 [System.Data.Odbc]: https://learn.microsoft.com/en-us/dotnet/api/system.data.odbc

docs/connect/odbc/python.md

@@ -121,14 +121,16 @@ Invoke program.
 python example.py
 ```
 
-## CrateDB Cloud
+## SSL connection
 
-For connecting to CrateDB Cloud, use the `Sslmode=require` parameter,
+Use the `Sslmode=require` parameter,
 and replace username, password, and hostname with values matching
 your environment.
+
+Also use this variant to connect to CrateDB Cloud.
 ```python
 connection_string = \
-    "Driver={PostgreSQL Unicode};Server=testcluster.cratedb.net;Port=5432;" \
+    "Driver={PostgreSQL Unicode};Server=testcluster.cratedb.net;Port=5432;Sslmode=require;" \
     "Uid=admin;Pwd=password;MaxVarcharSize=1073741824"
 ```
 

docs/connect/r/index.md

@@ -52,12 +52,14 @@ res <- dbGetQuery(conn, "SELECT * FROM sys.summits ORDER BY height DESC LIMIT 10
 print(res)
 ```
 
-:::{rubric} CrateDB Cloud
+:::{rubric} SSL connection
 :::
 
-For connecting to CrateDB Cloud, use `sslmode = "require"`, and
+Use `sslmode = "require"`, and
 replace hostname, username, and password with values matching
 your environment.
+
+Also use this variant to connect to CrateDB Cloud.
 ```r
 conn <- dbConnect(RPostgres::Postgres(),
                   host = "testcluster.cratedb.net",

docs/connect/rust/index.md

@@ -51,11 +51,13 @@ cargo add postgres
 cargo run
 ```
 
-:::{rubric} Synopsis (CrateDB Cloud)
+:::{rubric} Synopsis (SSL connection)
 :::
-For CrateDB Cloud, add TLS support and update the connection string with
+Add TLS support and update the connection string with
 your cluster details.
 
+Also use this variant to connect to CrateDB Cloud.
+
 `src/main.rs`
 ```rust
 use postgres::Client;