Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell is presented as the primary scripting example, and the CLI authentication example uses PowerShell syntax rather than Bash. There are no explicit Linux/macOS shell examples (e.g., Bash), and Windows-centric tools (PowerShell, Azure portal) are mentioned before cross-platform alternatives. This may create friction for Linux/macOS users who expect Bash or shell examples and parity in migration instructions.
Recommendations
- Provide Bash shell examples for Azure CLI commands, using standard Bash variable syntax and command chaining.
- Clarify that Azure CLI commands are cross-platform and show both Windows (PowerShell) and Linux/macOS (Bash) usage patterns.
- Include explicit instructions for Linux/macOS users, such as opening a terminal and using Bash, especially in the Azure CLI section.
- Where PowerShell is used, offer equivalent Bash commands for Linux/macOS users.
- Review screenshots and UI instructions to ensure they are not Windows-specific (e.g., referencing Windows-only features or UI elements).
Create Pull Request