Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a notable Windows bias: all code examples use PowerShell cmdlets, with no Azure CLI or Linux/macOS shell equivalents provided inline. Windows tools and patterns (PowerShell, cmdlets) are mentioned and demonstrated exclusively and before any reference to Linux alternatives. The only mention of Azure CLI is in a 'Next steps' link, rather than integrated examples. This creates friction for Linux/macOS users, who must seek out separate documentation or translate PowerShell examples themselves.
Recommendations
- Add inline Azure CLI examples alongside PowerShell for all key tasks (creating/listing proximity placement groups, creating scale sets, checking status).
- Explicitly mention Linux/macOS support and provide bash shell snippets where appropriate.
- Reorganize examples so that CLI and PowerShell approaches are presented together or in parallel sections.
- Ensure references to Linux documentation are as prominent as Windows/PowerShell equivalents.
- Clarify that all operations are cross-platform and not limited to Windows/PowerShell.
Create Pull Request