About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias by providing command-line instructions specifically for PowerShell, explicitly instructing users to open PowerShell as Administrator after installing the Azure CLI. There are no equivalent instructions or examples for Linux or macOS users, nor is there mention of using a Bash shell or terminal. The documentation assumes a Windows environment for CLI usage, and does not provide parity for Linux users.
Recommendations:
- Provide equivalent command-line instructions for Linux/macOS users, including examples using Bash or other common Linux shells.
- Avoid specifying 'PowerShell' as the default terminal unless the instructions are truly Windows-specific; instead, use neutral language such as 'open your terminal'.
- Include notes or callouts indicating that the Azure CLI commands work cross-platform, and provide any OS-specific prerequisites or differences.
- Where screenshots or UI steps are shown, clarify if there are any differences for Linux users, or confirm that the experience is the same.
- Add a section or callout for Linux/macOS users to ensure inclusivity and parity in the documentation.
Create pull request