Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides both Linux and Windows shell examples in the shell table, but the command-line syntax and examples focus primarily on Azure CLI (cross-platform) and Azure PowerShell (Windows-centric). The PowerShell cmdlet is mentioned before the Azure portal and template methods, and no Linux-specific command-line tool (e.g., Bash scripts, shell commands outside Azure CLI) is shown. The only Windows-specific tool referenced is PowerShell, and there are no Linux/macOS-specific command-line examples or troubleshooting tips. The shell table does mention Linux shells, but the documentation does not provide parity in examples for Linux-native workflows.
Recommendations
- Add explicit Linux/macOS command-line examples using Bash or shell scripts, especially for local testing or troubleshooting.
- Provide parity in example sections: if PowerShell is shown, also show equivalent Bash commands for Linux/macOS users.
- Include troubleshooting or usage notes for Linux/macOS users, such as file path conventions or shell differences.
- Clarify that Azure CLI is cross-platform and highlight any OS-specific considerations.
- Reorder examples so that cross-platform or Linux-native methods are presented before Windows-specific ones.
Create Pull Request