Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation consistently presents Azure PowerShell examples before Azure CLI examples, and relies heavily on PowerShell syntax and patterns throughout. There is no mention of Linux-specific shell usage (e.g., Bash), nor are there examples tailored for Linux environments. The use of PowerShell as the primary scripting language and the absence of references to Linux tools or shell environments indicate a Windows bias.
Recommendations
- Alternate the order of examples, sometimes presenting Azure CLI (which is cross-platform and native to Linux) before PowerShell.
- Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and provide sample Bash shell usage (e.g., variable assignment, command chaining).
- Include notes or sections for Linux/macOS users, such as differences in file paths, shell syntax, or environment setup.
- Avoid exclusive reliance on PowerShell scripting patterns (e.g., use of backticks for line continuation, variable assignment syntax) and show equivalent Bash syntax where appropriate.
- Add troubleshooting or setup tips for Linux environments, such as installation instructions for Azure CLI on Ubuntu or Fedora.
Create Pull Request