Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page includes several examples that reference Windows-specific tools and patterns, such as PowerShell and Azure PowerShell scripts, with no equivalent examples for Linux shell environments (e.g., Bash). PowerShell examples are presented alongside Azure CLI, but there is no parity for Linux-native scripting or command-line environments. The documentation mentions Windows-centric tools first (PowerShell) and does not provide Linux shell alternatives, which may disadvantage Linux users or those working in cross-platform environments.
Recommendations
- Add example prompts for Bash or Linux shell scripting, especially for resource management tasks currently shown only with PowerShell.
- Ensure parity between PowerShell and CLI examples by providing both Windows and Linux command-line alternatives for each scenario.
- Explicitly mention cross-platform compatibility for Azure CLI and clarify when PowerShell examples are Windows-specific.
- Consider reordering examples so that CLI (cross-platform) appears before PowerShell (Windows-centric) to reduce perceived Windows-first bias.
- Include prompts that demonstrate Linux administration tasks (e.g., using SSH, Bash scripts) in addition to Windows/PowerShell tasks.
Create Pull Request