2 files changed, 19 insertions, 5 deletions
diff --git a/Makefile b/Makefile
index c994fd3..7c92d1d 100644
--- a/Makefile
+++ b/Makefile
@@ -99,19 +99,19 @@ buildx/push:
 
 venv_dir := .venv
 
-.PHONY: venv-reset
-venv-reset:
+.PHONY: venv/reset
+venv/reset:
 	rm -rf -- '$(call escape,$(venv_dir))'
 	mkdir -p -- '$(call escape,$(venv_dir))'
 	python -m venv -- '$(call escape,$(venv_dir))'
 
 .PHONY: venv
-venv: venv-reset
+venv: venv/reset
 	. '$(call escape,$(venv_dir))/bin/activate' && pip install -r requirements.txt
 
 # Is there a better way?
-.PHONY: venv-update
-venv-update: venv-reset
+.PHONY: venv/upgrade
+venv/upgrade: venv/reset
 	. '$(call escape,$(venv_dir))/bin/activate' \
 		&& pip install . \
 		&& pip uninstall --yes "$$( python setup.py --name )" \
diff --git a/README.md b/README.md
index d9f3301..6a64b7f 100644
--- a/README.md
+++ b/README.md
@@ -51,6 +51,20 @@ Update the URL of an existing repository mirror:
 Development
 -----------
 
+### Virtual environment
+
+Create a virtual environment:
+
+    make venv
+
+Load a REPL:
+
+    make repl
+
+Upgrade virtual environment packages (this will also update requirements.txt):
+
+    make venv/upgrade
+
 ### Linting
 
 Requires [Pylint].