Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page exhibits a notable Windows bias. PowerShell is referenced heavily throughout, with explicit instructions and examples using 'Windows PowerShell' and paths like 'PS C:\Windows'. Installation instructions and sample outputs are Windows-centric, and there is frequent mention of Windows-specific tools and terminology. While Azure CLI is cross-platform, its usage is often demonstrated from a Windows PowerShell prompt, and there is little to no mention of Linux/macOS terminal environments or examples. There are no explicit Linux/macOS shell examples, nor are there instructions tailored for those platforms.
Recommendations
- Provide explicit Linux/macOS shell examples for Azure CLI commands (e.g., using bash/zsh syntax, showing output from a Linux terminal).
- Clarify that Azure CLI can be installed and used on Linux/macOS, and provide platform-specific installation instructions and links.
- Avoid using Windows PowerShell as the default context for CLI examples; alternate or parallel examples for bash should be included.
- Mention and demonstrate usage of Azure CLI in Linux/macOS environments, including sample outputs and screenshots where relevant.
- Where PowerShell is referenced, clarify its availability on Linux/macOS and provide instructions for installing PowerShell Core on those platforms, if relevant.
- Use neutral file paths and prompts (e.g., $ or user@host:~$) in CLI examples, or provide both Windows and Linux/macOS variants.
Create Pull Request