Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation page provides extensive PowerShell examples and references, which are primarily associated with Windows environments. PowerShell is presented as a first-class option alongside Azure CLI and portal, but its usage (including file paths like C:\temp\json.txt) and instructions (such as installing PowerShell modules) are Windows-centric. There are no explicit Linux/macOS shell script examples, and PowerShell examples use Windows-style paths and conventions. While Azure CLI is cross-platform and included, the prominence and detail of PowerShell instructions may create friction for Linux/macOS users.
Recommendations
- Include Bash or shell script examples for key tasks, especially for downloading and applying JSON policy files.
- Use platform-neutral file paths (e.g., /tmp/json.txt) in CLI and PowerShell examples, or provide both Windows and Linux/macOS variants.
- Clarify that PowerShell Core is available cross-platform, and provide installation instructions for Linux/macOS.
- Where PowerShell is used, add equivalent Bash/CLI commands for Linux/macOS users.
- Explicitly mention that Azure CLI is cross-platform and recommend it for Linux/macOS users.
Create Pull Request