Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation page demonstrates a moderate Windows bias. Azure PowerShell (a Windows-centric tool) is consistently presented before Azure CLI examples in each section, and PowerShell command output is shown with Windows-style prompts (e.g., 'PS C:\>'). There are no Linux-specific shell examples, and the narrative assumes familiarity with PowerShell conventions. The documentation does not mention Linux-specific tools, shell environments, or considerations, and does not provide parity in example output for Bash or other Linux shells.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present CLI examples first in some sections to avoid implicit prioritization of Windows tools.
- Include example outputs for Azure CLI commands, ideally shown in a Linux shell (e.g., Bash prompt), to demonstrate parity and usability for Linux users.
- Explicitly mention that Azure CLI works cross-platform and provide guidance for Linux/macOS users where relevant.
- Avoid using Windows-style prompts (e.g., 'PS C:\>') exclusively; consider showing CLI examples with '$' or other neutral prompts.
- Add a short section or note about running Azure CLI and PowerShell on Linux/macOS, including installation links and shell usage tips.
- Ensure that any advanced scripting examples (e.g., output parsing) are shown for both PowerShell and Bash where applicable.
Create Pull Request