Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by providing detailed PowerShell examples for key operations (template export, modification, deployment) without equivalent Azure CLI or Bash examples. PowerShell is a Windows-centric tool, and its use is prioritized over cross-platform alternatives. The Azure CLI is mentioned only in passing and not used in any step-by-step instructions. There are no Linux-specific instructions or examples, and the documentation assumes familiarity with PowerShell commands and patterns.
Recommendations
- Add step-by-step Azure CLI examples for all operations currently covered by PowerShell, including template export, modification, and deployment.
- Include Bash script examples for common tasks to demonstrate Linux parity.
- When listing tools or methods (e.g., Azure portal, CLI, PowerShell), present Azure CLI before or alongside PowerShell to avoid 'windows_first' ordering.
- Explicitly mention that all procedures can be performed on Linux, macOS, and Windows, and provide cross-platform guidance where relevant.
- Ensure troubleshooting tips and references include CLI-based solutions, not just PowerShell.
- Consider adding a table or section comparing PowerShell and CLI commands for each major step.
Create Pull Request