Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides extensive PowerShell examples and references, including file paths and commands that are most familiar to Windows users. PowerShell is presented as a primary automation method alongside Azure CLI, and several examples use Windows-style file paths (e.g., C:\temp\json.txt). While Azure CLI is covered and is cross-platform, PowerShell examples and terminology may create friction for Linux/macOS users. Additionally, PowerShell is listed before Azure CLI in most sections, and some instructions (such as saving or reading JSON files) use Windows conventions.
Recommendations
- Add Bash shell examples for key tasks, especially for file handling (e.g., saving and reading JSON files) to demonstrate Linux/macOS parity.
- Use platform-neutral file paths in examples (e.g., /tmp/json.txt or ./policy.json), or provide both Windows and Linux/macOS variants.
- Clarify that PowerShell Core is available cross-platform, and link to installation instructions for Linux/macOS where relevant.
- Where PowerShell is referenced, note that Azure CLI is fully supported and may be preferable for Linux/macOS users.
- Consider alternating the order of PowerShell and Azure CLI examples, or default to CLI first in sections not inherently Windows-centric.
Create Pull Request