diff --git a/docs/installation.qmd b/docs/installation.qmd
index 3a138b8..4a1823d 100644
--- a/docs/installation.qmd
+++ b/docs/installation.qmd
@@ -61,6 +61,8 @@ pipx install poetry
 poetry install
 ```
 
+(Note: if `psycopg2` installation fails with a `ChefBuildError`, you just need to install the PostgreSQL headers first and then try again.)
+
 3.  Activate shell
 
 ``` bash
diff --git a/index.qmd b/index.qmd
index b8a8eb9..03f7e63 100644
--- a/index.qmd
+++ b/index.qmd
@@ -87,6 +87,8 @@ pipx install poetry
 poetry install
 ```
 
+(Note: if `psycopg2` installation fails with a `ChefBuildError`, you just need to install the PostgreSQL headers first and then try again.)
+
 3.  Activate shell
 
 ``` bash
@@ -97,7 +99,7 @@ poetry shell
 
 ### Set environment variables
 
-Copy .env.example to .env with `cp .env.example .env`.
+Copy `.env.example` to `.env` with `cp .env.example .env`.
 
 Generate a 256 bit secret key with `openssl rand -base64 32` and paste it into the .env file.