Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides examples for Azure portal, PowerShell, Azure CLI, and ARM templates. PowerShell is featured prominently, with detailed instructions and examples, and is mentioned before Azure CLI in both creation and verification sections. PowerShell is a Windows-centric tool, and its inclusion and ordering may indicate a Windows bias. There are no Linux shell-specific examples (e.g., Bash scripts), and no mention of Linux-native tools or patterns. Azure CLI is cross-platform, but the absence of explicit Linux context or parity (such as Bash scripting or Linux package installation notes) reinforces the bias.
Recommendations
- Add explicit Bash shell examples for Azure CLI usage, showing Linux-style command usage and scripting.
- Include installation instructions for Azure CLI on Linux, not just a generic link.
- Reorder examples so that Azure CLI (cross-platform) appears before PowerShell, or present them side-by-side.
- Mention that PowerShell Core is available on Linux, if PowerShell examples are retained, and provide Linux installation instructions.
- Consider adding notes or examples for Linux users, such as using environment variables or shell scripting for automation.
- Ensure that all instructions and screenshots are platform-neutral or provide alternatives for Linux environments.
Create Pull Request