Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page demonstrates a Windows bias by presenting PowerShell examples first and in greater detail, referencing Windows-specific tools (PowerShell) and patterns, and mentioning Windows-centric approaches before their Linux equivalents. The CLI example is present but follows PowerShell, and there is no mention of Linux-specific shell usage or cross-platform scripting nuances. The tutorial also references the Azure portal and mobile app, which are platform-neutral, but the programmatic sections favor Windows tools and workflows.
Recommendations
- Present Azure CLI examples before or alongside PowerShell examples to emphasize cross-platform parity.
- Explicitly mention that Azure CLI works on Linux, macOS, and Windows, and provide shell-specific notes (e.g., bash, zsh) where relevant.
- Include Linux/macOS-specific instructions for installing and using Azure CLI and Terraform, such as package manager commands (apt, yum, brew).
- Add notes or examples for scripting budget creation using bash or other common Linux shells.
- Clarify that PowerShell Core is available on Linux/macOS, and provide installation instructions for those platforms.
- Ensure that REST API usage is highlighted as platform-agnostic and provide curl or httpie examples for Linux users.
- Review screenshots and UI instructions to ensure they are not Windows-centric (e.g., avoid referencing Windows-only UI elements or terminology).
Create Pull Request