Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a notable Windows bias, primarily through the frequent and prioritized use of PowerShell for examples and guidance. In several sections, PowerShell is mentioned before CLI or REST API alternatives, and in some cases, only PowerShell and REST API are provided as options for key tasks (such as retrieving .csdef and .cscfg files), with no explicit Azure CLI or Bash examples. There is also a lack of Linux/macOS-specific guidance or parity in automation/script references, and Visual Studio (a Windows-centric tool) is referenced for update workflows without alternatives for other platforms.
Recommendations
- Add explicit Azure CLI examples for all tasks currently shown with PowerShell, especially for retrieving deployment files (.csdef, .cscfg).
- Ensure CLI and REST API options are listed before or alongside PowerShell, not after.
- Include Bash script samples or references for automation tasks where appropriate.
- Mention cross-platform editors (such as VS Code) and provide update instructions for non-Windows environments.
- Clarify that all API and CLI methods are cross-platform, and highlight any platform-specific limitations or requirements.
Create Pull Request