Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits a moderate Windows bias. Windows tools and patterns (PowerShell, Windows CLI installation) are mentioned first or exclusively in several sections. PowerShell is given equal or slightly more prominence than Azure CLI, and CLI examples are written for Bash but with notes about adapting for Windows. Installation instructions for Azure CLI list Windows before Linux and macOS. There are no explicit Linux shell screenshots, and the workflow assumes familiarity with Windows conventions (e.g., Visual Studio Code, file paths).
Recommendations
- Present installation instructions for Azure CLI in a neutral order (e.g., Linux, macOS, Windows) or group them together.
- Include explicit Linux shell screenshots and examples, not just Bash CLI commands.
- Add notes or examples for Linux-specific file path conventions and shell environments.
- Ensure parity between PowerShell and CLI examples, and clarify that CLI works on all platforms (not just Bash/Windows).
- Mention alternative editors (e.g., Vim, nano) for Linux users alongside Visual Studio Code.
- Avoid language that assumes Windows as the default environment (e.g., 'workstation', 'File menu').
Create Pull Request