Bias Analysis
Detected Bias Types
windows_tools
powershell_heavy
windows_first
Summary
The documentation provides cross-platform guidance using REST API, Azure CLI, PowerShell, and ARM templates. However, there is a notable bias toward Windows tooling: PowerShell examples are present in every tabbed section, and references to PowerShell commands are frequent. The documentation refers to 'PowerShell' and 'PowerShell-interactive' in example blocks, which are Windows-centric, even though Azure PowerShell is available on Linux/macOS. Additionally, PowerShell examples are consistently shown alongside CLI, sometimes with more detail. There are no explicit Linux/macOS shell examples (e.g., bash scripts), and the CLI examples do not clarify platform differences. The documentation references 'Azure PowerShell' before CLI in some 'Learn more' links, and the overall pattern prioritizes Windows-native tooling.
Recommendations
- Add explicit bash/sh examples for Linux/macOS users, especially for common tasks.
- Clarify that Azure PowerShell is cross-platform, and provide installation/use guidance for Linux/macOS.
- Ensure CLI examples are shown first or in parallel with PowerShell, and highlight CLI as the recommended cross-platform tool.
- Where PowerShell is referenced, add notes or links for Linux/macOS installation and usage.
- Consider adding troubleshooting or environment setup notes for Linux/macOS users, especially where PowerShell is involved.
Create Pull Request