Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides detailed PowerShell (Windows-centric) instructions and examples before CLI (cross-platform) equivalents. The PowerShell section is significantly more comprehensive, with step-by-step breakdowns and explanations, while the CLI section is more concise and lacks equivalent depth. There are no Linux-specific examples or references, and the documentation implicitly assumes familiarity with PowerShell and Windows tools.
Recommendations
- Provide equally detailed Azure CLI examples and explanations for all steps, matching the depth of the PowerShell section.
- Explicitly mention that Azure CLI commands are cross-platform and can be used on Linux, macOS, and Windows.
- Add Bash shell usage examples where appropriate, especially for scripting or automation scenarios.
- Ensure that screenshots and UI references do not assume a Windows environment (e.g., avoid showing only Windows-style file paths or interfaces).
- Include a note or section for Linux users, highlighting any differences or considerations when using CLI or REST API.
- If PowerShell is required, clarify that PowerShell Core is available cross-platform and provide installation links for Linux/macOS.
Create Pull Request