Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation page provides both PowerShell and Azure CLI commands for deploying the template, but the PowerShell example is presented first and is visually emphasized. Additionally, the 'Next steps' section highlights PowerShell-based management before other cross-platform tools, and there is no explicit mention of Linux-specific considerations or parity in tooling. The Azure CLI example uses the legacy 'azure' CLI rather than the modern 'az' CLI, which is more cross-platform and recommended.
Recommendations
- Present Azure CLI examples before PowerShell examples, as Azure CLI is cross-platform and widely used on Linux and macOS.
- Update the Azure CLI example to use the modern 'az' CLI instead of the deprecated 'azure' CLI.
- Include explicit statements that all commands work on Linux, macOS, and Windows, and provide any necessary Linux-specific notes (e.g., shell syntax differences, installation instructions).
- In the 'Next steps' section, add links to Azure CLI and/or REST API management guides before or alongside PowerShell resources.
- Consider including a Bash shell example for template deployment to further demonstrate Linux parity.
Create Pull Request