Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all major steps. However, PowerShell is a Windows-centric tool, and its inclusion alongside CLI in every section may suggest a Windows bias. Additionally, PowerShell examples use Windows path separators (e.g., .\azuredeploy.json), and PowerShell is mentioned as a primary tool in prerequisites. There are no explicit Linux/macOS examples or notes about cross-platform usage for PowerShell, and the documentation does not clarify that Azure CLI is fully cross-platform.
Recommendations
- Clearly state that Azure CLI is fully cross-platform and recommended for Linux/macOS users.
- Add explicit notes or callouts for Linux/macOS users, especially regarding file path syntax differences (e.g., ./azuredeploy.json vs .\azuredeploy.json).
- Consider including Bash shell examples or notes for Linux/macOS users, especially for variable assignment and scripting.
- Reorder sections to present Azure CLI examples first, as it is the most cross-platform tool.
- Mention that Azure PowerShell is available on Linux/macOS via PowerShell Core, but CLI is simpler for most users outside Windows.
Create Pull Request