Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
windows_tools
Summary
The documentation shows mild Windows bias by listing Windows before Linux in the prerequisites, referencing Windows tools (such as Visual Studio) without Linux alternatives, and not providing explicit Linux/macOS command-line examples or guidance. Some steps reference PowerShell-based includes for resource group creation, which may default to Windows-centric instructions. There are no explicit Linux shell (bash) or macOS Terminal examples, and the authentication tooling mentions Visual Studio/VS Code (primarily Windows-focused) before CLI-based authentication.
Recommendations
- Ensure all command-line instructions are provided for both Windows (PowerShell/CMD) and Linux/macOS (bash), or use cross-platform Azure CLI examples as the default.
- When referencing tools for authentication, mention cross-platform options (Azure CLI, VS Code) before Windows-only tools (Visual Studio), and clarify that VS Code is available on all platforms.
- In prerequisites and setup sections, list Linux/macOS alongside Windows, or use neutral phrasing (e.g., 'on your computer' instead of 'on a computer running Windows or Linux').
- If includes reference PowerShell, ensure equivalent bash/CLI instructions are also linked or shown.
- Explicitly state that all examples work on Linux/macOS as well as Windows, and provide troubleshooting notes for common cross-platform issues (e.g., OpenSSL installation, npm usage).
Create Pull Request