Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page shows evidence of Windows bias. Azure PowerShell (primarily a Windows tool) is presented as a first-class option alongside Azure CLI, and installation instructions for the Azure CLI list Windows before Linux and macOS. The editor recommendation is Visual Studio Code, which, while cross-platform, is traditionally associated with Windows. There is no mention of Linux-specific editors or shell environments beyond Bash, and no explicit parity checks for Linux users. The PowerShell examples are given equal prominence to CLI examples, but PowerShell is more commonly used on Windows.
Recommendations
- List Azure CLI installation instructions for Linux before Windows to avoid implicit prioritization.
- Include examples or recommendations for Linux-native editors (e.g., Vim, Nano, Emacs) alongside Visual Studio Code.
- Clarify that Azure PowerShell is available cross-platform, but is most commonly used on Windows, and suggest CLI as the default for Linux/macOS users.
- Add explicit notes or tips for Linux users regarding shell compatibility and file path conventions.
- Ensure that all examples are tested and presented in a way that is equally accessible to Linux users, possibly including screenshots or terminal output from Linux environments.
Create Pull Request