Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits several Windows-centric biases. PowerShell is featured prominently as a primary automation method, with instructions explicitly referencing 'Windows PowerShell' and examples using Windows-style paths (e.g., C:\temp\index.html). In several places, Windows tools and terminology are mentioned first or exclusively (e.g., suggesting 'Windows PowerShell' as the console for Azure CLI, using Windows file paths in examples, and referencing Windows-specific installation instructions). There is a lack of explicit Linux or macOS examples, and Linux shell conventions (such as bash, zsh, or POSIX paths) are not shown, which may lead Linux users to feel unsupported or confused.
Recommendations
- Provide explicit Linux/macOS instructions and examples alongside Windows ones, especially for CLI and PowerShell sections.
- Use platform-neutral terminology when referring to command consoles (e.g., 'terminal' or 'command line'), and clarify that Azure CLI can be used from any OS.
- Include Linux-style file path examples (e.g., /home/user/index.html) in CLI and PowerShell sections.
- Mention alternative shells (bash, zsh) and tools where relevant, and avoid implying that PowerShell is required or preferred for CLI usage.
- Add notes or tabs for Linux/macOS users where installation or usage steps differ, ensuring parity in guidance and examples.
Create Pull Request