Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides detailed, step-by-step examples for Azure PowerShell (a Windows-centric tool) before Azure CLI, including advanced formatting and JSON output. PowerShell examples use Windows-specific conventions (e.g., 'PS C:\>'), and the CLI section is less detailed, with no mention of Linux-specific shell usage or scripting. There are no Linux shell (bash/zsh) examples, nor is there guidance for Linux users regarding environment setup or command usage. The REST API section is platform-neutral, but the scripting examples overall favor Windows/PowerShell.
Recommendations
- Add Linux shell (bash/zsh) examples for Azure CLI commands, including sample output and usage in typical Linux environments.
- Provide parity in advanced examples (e.g., formatting, JSON output) for Azure CLI, showing how to use jq or other Linux tools for processing output.
- Include notes or sections on environment setup for Linux users, such as installing Azure CLI on Linux and running commands in bash.
- Avoid using Windows-specific conventions (e.g., 'PS C:\>') in examples unless also providing Linux equivalents.
- Ensure that CLI examples are as detailed and comprehensive as PowerShell examples, covering similar scenarios and output formats.
Create Pull Request