Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation demonstrates a moderate Windows bias. PowerShell examples are presented before Azure CLI in every code sample section, and PowerShell is referenced in prerequisites and notes as a primary tool. The use of PowerShell and Windows-centric terminology (e.g., 'Azure PowerShell module') is prevalent, while Linux-specific shell examples (such as Bash) are not provided. Although Azure CLI is cross-platform, the CLI examples use variable syntax ($var) that is more familiar to Windows/PowerShell users than to Linux/Bash users. No Linux-specific tools or patterns are mentioned, and there are no explicit Bash or Linux shell script examples.
Recommendations
- Provide Bash/Linux shell script examples alongside PowerShell and Azure CLI, using Linux-style variable syntax (e.g., RgName="value") and export statements.
- Clarify that Azure CLI commands can be run on Linux, macOS, and Windows, and show examples for each platform where syntax differs.
- Avoid presenting PowerShell examples before CLI or Bash examples; alternate the order or present all options equally.
- Explicitly mention Linux as a supported platform in prerequisites and instructions, and link to Linux-specific installation guides.
- Where variable assignment is shown, use syntax appropriate for each platform (e.g., $var for PowerShell, var=value for Bash).
Create Pull Request