Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page for Azure Blueprints exhibits a mild Windows bias. In the 'Next steps' section, PowerShell is listed as the only command-line example, with no mention of Bash, Azure CLI, or Linux shell equivalents. The ordering places PowerShell before REST API, and there are no Linux-specific instructions or examples. Throughout the page, there is no reference to Linux tools or cross-platform command-line usage, and the only scripting example provided is for PowerShell, which is primarily a Windows tool (although it is available cross-platform).
Recommendations
- Add Azure CLI (az) examples for blueprint creation and management, and link to them alongside PowerShell and REST API.
- Explicitly mention that PowerShell is available cross-platform, but also provide Bash or shell script equivalents for common tasks.
- Reorder the 'Next steps' section to present cross-platform tools (e.g., Portal, Azure CLI, REST API) before or alongside PowerShell.
- Include a note or section on how Linux users can interact with Azure Blueprints, especially for automation and scripting.
- Ensure that future documentation updates provide parity between Windows and Linux tooling and examples.
Create Pull Request