Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation exhibits a Windows bias in several ways: PowerShell is presented as the primary or only scripting example in many sections, with explicit references to Windows file paths (e.g., C:\Users\SampleUser\Downloads) and Windows-centric instructions. Azure CLI examples are present, but PowerShell commands and terminology are often given first or exclusively, and Linux/macOS-specific details (such as file paths, shell usage, or troubleshooting) are missing. There are no explicit Linux shell examples, and the documentation assumes familiarity with Windows conventions.
Recommendations
- Provide Linux/macOS-specific instructions and examples alongside Windows ones, especially for file paths and shell usage.
- Ensure Azure CLI examples use POSIX-style paths (e.g., /home/username/Downloads/LOA.pdf) and clarify cross-platform compatibility.
- Avoid referencing Windows-only locations (such as C:\Users\...) without also showing Linux/macOS equivalents.
- Explicitly state that Azure CLI and Cloud Shell work on Linux/macOS and provide troubleshooting tips for those platforms.
- Where PowerShell is used, clarify if PowerShell Core (cross-platform) is supported and provide bash/zsh alternatives where possible.
- Review the ordering of examples so that Azure CLI (cross-platform) is presented before or alongside PowerShell, not after.
Create Pull Request