Bias Analysis
Detected Bias Types
missing_windows_example
linux_first
windows_exclusion
Summary
The documentation page demonstrates a bias against Windows by explicitly stating that control plane deployment cannot be performed from Windows, while providing detailed Linux instructions and examples. Windows users are excluded from the main deployment workflow and only receive instructions for optional or ancillary tasks (e.g., preparing the web app). Linux instructions are presented first and in more detail, with Windows relegated to a brief note or omitted entirely for core tasks.
Recommendations
- Investigate and document any possible methods for Windows users to perform control plane deployment, such as using WSL (Windows Subsystem for Linux), Docker, or cross-platform scripting tools.
- If Windows deployment is fundamentally unsupported, clearly explain the technical reasons and suggest practical workarounds (e.g., using Azure Cloud Shell, a Linux VM, or WSL on Windows).
- Ensure that all ancillary tasks (such as SSH key management, configuration file editing, and script execution) have Windows-specific instructions, including examples using PowerShell, PuTTY, or other common Windows tools.
- Present platform instructions in parallel (side-by-side tabs) and with equal detail, rather than prioritizing Linux.
- Regularly review and update documentation to maintain parity as platform support evolves.
Create Pull Request