From 0e7af7b77b1dacd5a87d41d606138f3471d9430c Mon Sep 17 00:00:00 2001
From: Wolfgang Walther <walther@technowledgy.de>
Date: Sun, 18 Feb 2024 15:58:51 +0100
Subject: [PATCH] docs: Various formatting improvements

---
 docs/explanations/install.rst | 17 +++++++++--------
 docs/tutorials/tut0.rst       |  2 +-
 docs/tutorials/tut1.rst       |  4 ++--
 3 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/docs/explanations/install.rst b/docs/explanations/install.rst
index b2935a937..f1ae253c3 100644
--- a/docs/explanations/install.rst
+++ b/docs/explanations/install.rst
@@ -163,14 +163,15 @@ If you want to have a visual overview of your API in your browser you can add sw
 
 .. code-block:: yaml
 
-  swagger:
-    image: swaggerapi/swagger-ui
-    ports:
-      - "8080:8080"
-    expose:
-      - "8080"
-    environment:
-      API_URL: http://localhost:3000/
+  # in services:
+    swagger:
+      image: swaggerapi/swagger-ui
+      ports:
+        - "8080:8080"
+      expose:
+        - "8080"
+      environment:
+        API_URL: http://localhost:3000/
 
 With this you can see the swagger-ui in your browser on port 8080.
 
diff --git a/docs/tutorials/tut0.rst b/docs/tutorials/tut0.rst
index 3d9a5eae7..c2fa5f33a 100644
--- a/docs/tutorials/tut0.rst
+++ b/docs/tutorials/tut0.rst
@@ -30,7 +30,7 @@ If Docker is not installed, you can get it `here <https://www.docker.com/get-sta
 .. code-block:: bash
 
   sudo docker run --name tutorial -p 5433:5432 \
-                  -e POSTGRES_PASSWORD=mysecretpassword \
+                  -e POSTGRES_PASSWORD=notused \
                   -d postgres
 
 This will run the Docker instance as a daemon and expose port 5433 to the host system so that it looks like an ordinary PostgreSQL server to the rest of the system.
diff --git a/docs/tutorials/tut1.rst b/docs/tutorials/tut1.rst
index 2bde08c5b..979e75d98 100644
--- a/docs/tutorials/tut1.rst
+++ b/docs/tutorials/tut1.rst
@@ -140,7 +140,7 @@ It's better policy to include an expiration timestamp for tokens using the :code
 
   Epoch time is defined as the number of seconds that have elapsed since 00:00:00 Coordinated Universal Time (UTC), January 1st 1970, minus the number of leap seconds that have taken place since then.
 
-To observe expiration in action, we'll add an :code:`exp` claim of five minutes in the future to our previous token. First find the epoch value of five minutes from now. In psql run this:
+To observe expiration in action, we'll add an :code:`exp` claim of five minutes in the future to our previous token. First find the epoch value of five minutes from now. In :code:`psql` run this:
 
 .. code-block:: postgres
 
@@ -155,7 +155,7 @@ Go back to jwt.io and change the payload to
     "exp": 123456789
   }
 
-**NOTE**: Don't forget to change the dummy epoch value :code:`123456789` in the snippet above to the epoch value returned by the psql command.
+**NOTE**: Don't forget to change the dummy epoch value :code:`123456789` in the snippet above to the epoch value returned by the :code:`psql` command.
 
 Copy the updated token as before, and save it as a new environment variable.