Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation page demonstrates a moderate Windows bias, especially in the 'Create and edit budgets' section. PowerShell is presented as the first and most detailed programmatic example, with CLI and Terraform following. The PowerShell example assumes users are familiar with Windows tooling and patterns, and the CLI example is less detailed. There is no mention of Linux/macOS-specific considerations, nor are cross-platform differences discussed. The use of PowerShell as the primary automation example and its placement before CLI and Terraform can create friction for Linux/macOS users.
Recommendations
- Present CLI examples before or alongside PowerShell, as Azure CLI is cross-platform and preferred by many Linux/macOS users.
- Explicitly state that Azure CLI and Terraform are fully supported on Linux/macOS, and provide links to installation guides for those platforms.
- Add notes or sections discussing any platform-specific differences, such as authentication or environment setup, for Linux/macOS users.
- Ensure that all automation and scripting examples have parity between PowerShell and CLI, and that CLI examples are as detailed as PowerShell ones.
- Consider including Bash shell script examples for common tasks, or referencing Bash usage where appropriate.
Create Pull Request