README.md

@@ -85,16 +85,16 @@ make makemigrations
    hatch run dev:server
    ```
 
-#### Upgrade requirements
+### Updating requirements
 
-We use hatch-pip-compile.
+We use hatch-pip-compile. That means we have a set of loosely defined `dependencies` in `pyproject.toml` and then we can keep the exactly pinned version in our `requirements.txt` (auto-generated).
+
+To generate `requirements.txt` and `requirements/requirements-dev.txt`, run the following command:
 
 ```bash
-# Install hatch-pip-compile in some environment
+# Build requirements.txt etc
-pipx install hatch-pip-compile
+make requirements
-# Change requirements in pyproject.toml (...)
+
-# Update requirements.txt:
+# Build Docker image with new Python requirements
-hatch-pip-compile
+make build
-# Update requirements/requirements-dev.txt:
-hatch-pip-compile dev
 ```