Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation page demonstrates a moderate Windows bias. The Azure PowerShell section is more extensive, with multiple examples and output formats, compared to the Azure CLI section. PowerShell examples use Windows-specific conventions (e.g., PS C:\> prompt, Format-Table, ConvertTo-Json, Format-List), and are presented before Azure CLI examples. There is no explicit mention of Linux shell equivalents for PowerShell commands, nor are there Bash or shell scripting examples. The documentation assumes familiarity with Windows tools and patterns, such as PowerShell cmdlets and output formatting, without providing Linux alternatives or guidance.
Recommendations
- Add equivalent Bash/shell scripting examples for listing and formatting role definitions using Azure CLI, including output manipulation with jq or grep.
- Present Azure CLI examples before or alongside PowerShell examples to avoid Windows-first ordering.
- Clarify that Azure CLI works cross-platform and provide explicit instructions for Linux/macOS users, including installation and usage notes.
- Where PowerShell output formatting is shown (e.g., Format-Table, Format-List), provide CLI equivalents using jq or other Linux-friendly tools.
- Avoid Windows-specific prompts (e.g., PS C:\>) in examples, or provide alternative prompts for Linux/macOS.
Create Pull Request