Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation consistently presents Azure PowerShell (a Windows-centric tool) examples before Azure CLI examples, and provides no explicit Linux/macOS shell (e.g., Bash) instructions or screenshots. While Azure CLI is cross-platform, there are no Linux-specific notes, nor are there any examples using native Linux tools or terminal environments. The clean-up section only describes using the Azure Portal (web UI), not command-line options, and the prerequisites mention Visual Studio Code but do not mention Linux editors or shells.
Recommendations
- Alternate the order of Azure PowerShell and Azure CLI examples, or present Azure CLI (the more cross-platform tool) first.
- Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and provide example shell environments (e.g., Bash, zsh).
- Add Linux/macOS-specific notes or screenshots where relevant (e.g., for file paths or shell variables).
- In the prerequisites, mention popular Linux editors (e.g., vim, nano) and shells as alternatives to Visual Studio Code.
- For resource clean-up, provide Azure CLI commands to delete the resource group, in addition to the Azure Portal instructions.
- Where variables are used (e.g., $templateFile), clarify shell syntax differences between PowerShell and Bash.
Create Pull Request