Connect/Erlang: Copy editing

Author: amotl

docs/connect/erlang/epgsql.md

@@ -41,14 +41,6 @@ start() ->
     init:stop().
 ```
 
-:::{include} ../_cratedb.md
-:::
-```shell
-rebar3 compile
-erlc epgsql_example.erl
-rebar3 shell --eval 'epgsql_example:start().'
-```
-
 :::{rubric} CrateDB Cloud
 :::
 
@@ -71,6 +63,19 @@ start() ->
     }),
 ```
 
+:::{rubric} Example
+:::
+
+Create the files `rebar.config` and `epgsql_example.erl` including the synopsis code shared above.
+
+:::{include} ../_cratedb.md
+:::
+```shell
+rebar3 compile
+erlc epgsql_example.erl
+rebar3 shell --eval 'epgsql_example:start().'
+```
+
 
 [epgsql]: https://github.com/epgsql/epgsql
 [SSL application]: https://www.erlang.org/docs/28/apps/ssl/ssl_app.html

docs/connect/erlang/odbc.md

@@ -38,12 +38,6 @@ main(_) ->
     init:stop().
 ```
 
-:::{include} ../_cratedb.md
-:::
-```shell
-escript odbc_example.erl
-```
-
 :::{rubric} CrateDB Cloud
 :::
 
@@ -63,6 +57,18 @@ main(_) ->
     init:stop().
 ```
 
+:::{rubric} Example
+:::
+
+Create the file `odbc_example.erl` including the synopsis code shared above.
+
+:::{include} ../_cratedb.md
+:::
+```shell
+escript odbc_example.erl
+```
+
 
 [Erlang ODBC examples]: https://www.erlang.org/doc/apps/odbc/getting_started.html
 [ODBC application]: https://www.erlang.org/docs/28/apps/odbc/odbc.html
+[SSL application]: https://www.erlang.org/docs/28/apps/ssl/ssl_app.html