Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation page demonstrates a mild Windows bias. In the 'Required access' section, the PowerShell example (New-AzRoleAssignment) is presented before the Azure CLI example, which may subtly prioritize Windows tooling. The page also includes dedicated tabs for both Azure CLI and PowerShell deployment commands, but does not provide explicit Linux shell (bash) or cross-platform scripting examples, nor does it mention platform-specific considerations for Linux users. There are no references to Linux-native tools or patterns, and no explicit mention of running these commands from Linux environments.
Recommendations
- Ensure that Azure CLI examples (which are cross-platform) are presented before PowerShell examples, or in parallel, to avoid implicit prioritization of Windows tools.
- Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and provide sample bash scripts or usage from Linux terminals where appropriate.
- Add notes or examples for running deployments from Linux environments, such as using bash or zsh, and clarify any platform-specific differences (if any).
- Consider including a section or tip highlighting cross-platform compatibility and recommending Azure CLI for users on Linux or macOS.
- Avoid using PowerShell-specific syntax (such as backticks for line continuation) in examples unless also providing bash equivalents.
Create Pull Request