diff --git a/docs/python-venv.md b/docs/python-venv.md
index 4f3f8ac..5c62131 100644
--- a/docs/python-venv.md
+++ b/docs/python-venv.md
@@ -22,4 +22,11 @@ or
     . .venv/bin/activate
 ```
 
-To exit the virtual environment use the command/script `deactivate`.
\ No newline at end of file
+To exit the virtual environment use the command/script `deactivate`.
+
+
+## troubleshooting
+
+### the command prompt does not show the venv prompt
+If one customised the command prompt, that might interfere with the venv prompt.
+When using `starship` one needs to enable and include the `python` module.
\ No newline at end of file