Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides deployment command examples for both Azure CLI and Azure PowerShell, but the PowerShell example is given equal prominence and detail as the CLI example. There is no mention of Linux-specific shell environments (such as Bash) or explicit Linux command-line patterns. The references to Cloud Shell do not clarify parity between Bash and PowerShell environments, and there are no Linux-specific troubleshooting or usage notes. The documentation implicitly assumes familiarity with PowerShell, which is primarily a Windows tool, and does not offer guidance for Linux users beyond the generic Azure CLI example.
Recommendations
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and clarify any OS-specific prerequisites.
- Add Bash-specific examples or notes where appropriate, especially for deployment commands and scripting.
- Clarify that Cloud Shell supports both Bash and PowerShell, and provide links or examples for both environments.
- Avoid giving PowerShell examples equal or greater prominence than CLI/Bash unless justified by feature parity.
- Include troubleshooting notes or tips for Linux users, such as file path differences or authentication nuances.
Create Pull Request