Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation exhibits a moderate Windows bias. Windows-centric tools (PowerShell, ARMClient) are emphasized, and Windows installation instructions for Azure CLI are given before Linux equivalents. PowerShell examples are presented first and in greater detail, with Linux/macOS alternatives (such as Bash or shell scripting) absent. ARMClient is a Windows-only tool, and its use is recommended without Linux alternatives.
Recommendations
- Provide installation instructions for Azure CLI on Linux/macOS alongside Windows, or link to the cross-platform install page.
- Include Bash or shell scripting examples for policy creation and assignment, especially for Azure CLI and REST API usage.
- Mention cross-platform alternatives to ARMClient (such as curl or httpie) for REST API calls, with example commands.
- Alternate the order of examples so that Azure CLI or REST API (which are cross-platform) are shown before PowerShell.
- Explicitly note which tools are Windows-only and suggest Linux/macOS equivalents.
Create Pull Request