Adjustments to authentication doc

Author: bcb

docs/authentication.md

@@ -20,8 +20,8 @@ Edit `postgres/Dockerfile` to build and install the extension:
 
 ```sh
 RUN apt-get update && apt-get install -y \
- build-essential \
- postgresql-server-dev-17
+  build-essential \
+  postgresql-server-dev-17
 
 # pgjwt - used by auth schema
 COPY ./pgjwt /pgjwt
@@ -37,14 +37,22 @@ Then rebuild:
 docker compose build postgres
 ```
 
+And recreate the running container:
+
+```sh
+docker compose up -d postgres
+```
+
 ## ➡️ 2. Add Migrations
 
 ### 📚 Load Required Extensions
 
 Add this to a migration file like `01-extensions.sql`:
 
 ```sql
--- pgcrypto adds public.crypt used in auth.encrypt_pass
+/* pgcrypto adds public.crypt used in auth.encrypt_pass pgjwt also needs this
+so it must be loaded first. pgcrypto is built into Postgres, so no need to
+install it. */
 create extension pgcrypto;
 
 -- pgjwt adds public.sign used in auth.generate_access_token
@@ -212,7 +220,7 @@ commit;
 
 ### 👮 Grant Permissions
 
-Add another migration such as `99-roles_and_grants.sql`:
+Add another migration such as `99-grants.sql`:
 
 ```sql
 begin;