Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation demonstrates a Windows bias by requiring PowerShell for variable assignment and scripting, referencing PowerShell installation as a prerequisite, and using PowerShell-specific constructs (e.g., `$variable` syntax, backticks for line continuation, ConvertFrom-Json, Out-String). Windows parameter file examples are presented before Linux ones, and Windows tools (PowerShell, Microsoft Graph SDK for PowerShell) are referenced without Linux alternatives. There are no explicit Bash or Linux shell equivalents for variable assignment, scripting, or Azure CLI usage, which may hinder Linux users.
Recommendations
- Provide Bash/Linux shell examples for variable assignment and scripting alongside PowerShell examples.
- List Linux prerequisites (e.g., Bash, Azure CLI installation on Linux) equally with Windows prerequisites.
- Use cross-platform syntax for Azure CLI commands, avoiding PowerShell-specific constructs (e.g., `$variable`, backticks, ConvertFrom-Json).
- Present Linux and Windows parameter file examples in parallel or alternate their order to avoid Windows-first bias.
- Reference Linux-native tools (e.g., Microsoft Graph CLI, jq for JSON parsing) where PowerShell is mentioned.
- Clarify which steps are OS-agnostic and which require OS-specific tools, providing guidance for both platforms.
Create Pull Request