diff --git a/cmd/venv.md b/cmd/venv.md
index 1640a78..6e7a289 100644
--- a/cmd/venv.md
+++ b/cmd/venv.md
@@ -1,5 +1,17 @@
-* create `python -m venv [env]`
-* activate `source [env]/bin/activate` 
+## New python project with virtual env in ZED
+
+* create $PROJECT `mkdir project; cd project`
+* create `python -m venv .venv`
+* activate `source .venv/bin/activate` 
 * `deactivate`
+* create pyrightconfig.json
+```json
+{
+  "venvPath": ".",
+  "venv": ".venv"
+}
+```
+* `pip install ...`
+* `zed .`