Update README files for by-language examples

Author: amotl

by-language/csharp-npgsql/README.rst

@@ -1,8 +1,13 @@
 .. highlight: console
 
-=================================================================
-Basic demonstration program for using CrateDB with vanilla Npgsql
-=================================================================
+#######################################################
+Basic example for connecting to CrateDB using .NET (C#)
+#######################################################
+
+
+*****
+About
+*****
 
 CrateDB versions prior to 4.2 needed a custom fork of the official Npgsql .NET
 data provider for PostgreSQL, `crate-npgsql`_. CrateDB versions 4.2 and later
@@ -12,44 +17,45 @@ The file ``DemoProgram.cs`` is a demonstration program written in C# which
 outlines typical, very basic usage scenarios with CrateDB.
 
 
+
+*****
 Usage
-=====
+*****
 
 To invoke a CrateDB instance for evaluation purposes, run::
 
-    sh$ docker run -it --rm --publish=4200:4200 --publish=5432:5432 crate:4.5.1
+    docker run -it --rm --publish=4200:4200 --publish=5432:5432 crate:4.5.1
 
-For building and running the demonstration program and connect to
-``localhost:5432``, invoke::
+Invoke example program::
 
-    sh$ dotnet run --framework=net5.0
+    dotnet run --framework=net5.0
 
 To connect to CrateDB Cloud, use a command like::
 
-    sh$ dotnet run --framework=net5.0 -- \
+    dotnet run --framework=net5.0 -- \
         --host=clustername.aks1.westeurope.azure.cratedb.net --ssl-mode=Require \
         --username=foobar --password='X8F%Shn)TESTvF5ac7%eW4NM'
 
 Explore all available options::
 
-    sh$ dotnet run --framework=net5.0 -- --help
+    dotnet run --framework=net5.0 -- --help
 
 
 Tests
 =====
 
 For running the test scenarios wrapped into a xUnit test suite, invoke::
 
-    sh$ dotnet test --framework=net5.0
+    dotnet test --framework=net5.0
 
 To generate a Cobertura code coverage report, run::
 
-    sh$ dotnet test --framework=net5.0 --collect:"XPlat Code Coverage"
+    dotnet test --framework=net5.0 --collect:"XPlat Code Coverage"
 
 For running the tests against a remote database, use, for example::
 
-    sh$ export CRATEDB_DSN='Host=clustername.aks1.westeurope.azure.cratedb.net;Port=5432;SSL Mode=Require;Username=foobar;Password=X8F%Shn)TESTvF5ac7%eW4NM;Database=testdrive'
-    sh$ dotnet test --framework=net5.0
+    export CRATEDB_DSN='Host=clustername.aks1.westeurope.azure.cratedb.net;Port=5432;SSL Mode=Require;Username=foobar;Password=X8F%Shn)TESTvF5ac7%eW4NM;Database=testdrive'
+    dotnet test --framework=net5.0
 
 
 .. _crate-npgsql: https://github.com/crate/crate-npgsql

by-language/java-jdbc/README.rst

@@ -1,3 +1,5 @@
+.. highlight: console
+
 ##################################################
 Basic example for connecting to CrateDB using JDBC
 ##################################################
@@ -20,20 +22,18 @@ it makes sense to also have a look at the `PostgreSQL documentation about schema
 Usage
 *****
 
-Run CrateDB::
+To invoke a CrateDB instance for evaluation purposes, run::
 
-    docker run -it --rm --publish=4200:4200 --publish=5432:5432 crate/crate:4.6.1
+    docker run -it --rm --publish=4200:4200 --publish=5432:5432 crate:5.1.1
 
 Create schema and insert data::
 
     psql postgres://crate@localhost:5432/doc
 
-::
+.. code-block:: sql
 
-    crate=> CREATE TABLE testdrive (id INT PRIMARY KEY, data TEXT);
-    CREATE 1
-    crate=> INSERT INTO testdrive VALUES (0, 'zero'), (1, 'one'), (2, 'two');
-    INSERT 0 3
+    CREATE TABLE testdrive (id INT PRIMARY KEY, data TEXT);
+    INSERT INTO testdrive VALUES (0, 'zero'), (1, 'one'), (2, 'two');
 
 Invoke example program::