Document Windows venv activation

Author: SiboVG

docs/install.md

@@ -16,6 +16,20 @@ python3 -m venv .venv --prompt=dip-coater
 source .venv/bin/activate
 ```
 
+On Windows PowerShell:
+
+```powershell
+py -m venv .venv --prompt dip-coater
+.\.venv\Scripts\Activate.ps1
+```
+
+On Windows Command Prompt:
+
+```bat
+py -m venv .venv --prompt dip-coater
+.venv\Scripts\activate.bat
+```
+
 Upgrade pip (optional):
 
 ```bash
@@ -58,6 +72,10 @@ python3 -m pip install --upgrade pip
 python3 -m pip install -e .
 ```
 
+On Windows, use the same commands but activate the virtual environment with
+`.\.venv\Scripts\Activate.ps1` in PowerShell or `.venv\Scripts\activate.bat`
+in Command Prompt.
+
 On a Raspberry Pi with GPIO hardware:
 
 ```bash
@@ -90,6 +108,18 @@ source .venv/bin/activate
 python3 -m pip install --upgrade dip-coater
 ```
 
+On Windows, activate the virtual environment with:
+
+```powershell
+.\.venv\Scripts\Activate.ps1
+```
+
+Or from Command Prompt:
+
+```bat
+.venv\Scripts\activate.bat
+```
+
 On a Raspberry Pi with GPIO hardware:
 
 ```bash

docs/troubleshooting.md

@@ -17,6 +17,20 @@ source .venv/bin/activate
 dip-coater --help
 ```
 
+On Windows PowerShell:
+
+```powershell
+.\.venv\Scripts\Activate.ps1
+dip-coater --help
+```
+
+On Windows Command Prompt:
+
+```bat
+.venv\Scripts\activate.bat
+dip-coater --help
+```
+
 If you installed with uv, run:
 
 ```bash

src/test/test_docs_content.py

@@ -6,6 +6,8 @@ def test_install_docs_explain_software_updates_and_version_check():
 
     assert "python3 -m pip install dip-coater" in install_docs
     assert "python3 -m pip install --upgrade dip-coater" in install_docs
+    assert ".\\.venv\\Scripts\\Activate.ps1" in install_docs
+    assert ".venv\\Scripts\\activate.bat" in install_docs
     assert "dip-coater --version" in install_docs
     assert "uv run dip-coater --version" in install_docs
     assert "## Source Checkout Install" in install_docs
@@ -68,6 +70,16 @@ def test_run_docs_explain_session_log_file():
     assert "JSON lines" in run_docs
 
 
+def test_troubleshooting_docs_include_windows_venv_activation():
+    troubleshooting_docs = (
+        Path(__file__).parents[2] / "docs" / "troubleshooting.md"
+    ).read_text()
+
+    assert "source .venv/bin/activate" in troubleshooting_docs
+    assert ".\\.venv\\Scripts\\Activate.ps1" in troubleshooting_docs
+    assert ".venv\\Scripts\\activate.bat" in troubleshooting_docs
+
+
 def test_python_examples_docs_reference_example_scripts():
     examples_docs = (
         Path(__file__).parents[2] / "docs" / "python-examples.md"