Skip to content

Commit dd652cb

Browse files
committed
docs: Add comprehensive Windows troubleshooting guide
Add a detailed Windows troubleshooting guide to improve user experience for Windows users installing and using ScanCode Toolkit. The guide covers 10 comprehensive sections: - PowerShell execution policy issues and solutions - Virtual environment activation problems - Python installation and PATH configuration - Pip installation failures and build tools - Configure script failures and cleanup procedures - Long path issues and Group Policy solutions - Antivirus and Windows Defender configuration - Performance optimization recommendations - Diagnostic PowerShell script for prerequisite checking - Common error messages and their solutions Features: - Practical solutions tested on Windows 11 with Python 3.12 - Step-by-step instructions with PowerShell code examples - Proper reStructuredText formatting with admonitions - Security considerations and warnings where appropriate - Links to additional resources and GitHub issues This addresses common pain points Windows users encounter during installation and setup, reducing support burden and improving the overall user experience. Fixes #windows-user-experience Signed-off-by: dhruv1955 <dhruvyadav042905@gmail.com>
1 parent 022ddc8 commit dd652cb

File tree

2 files changed

+529
-0
lines changed

2 files changed

+529
-0
lines changed

docs/source/getting-started/installation/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ Installing ScanCode
1111
install-scancode-using-docker
1212
install-scancode-from-source
1313
install-scancode-using-pip
14+
windows-troubleshooting
1415

1516
.. note::
1617

0 commit comments

Comments
 (0)