Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides extensive PowerShell examples and instructions, which are most commonly used on Windows. PowerShell is presented as a primary automation method alongside Azure CLI, but file path examples and instructions (e.g., 'C:\temp\json.txt') are Windows-centric. There is a lack of explicit parity for Linux/macOS users in PowerShell sections, and Windows-style file paths are used before mentioning cross-platform alternatives. However, Azure CLI examples are present and generally cross-platform, reducing the overall severity.
Recommendations
- Explicitly state that PowerShell Core is available on Linux/macOS and provide equivalent Linux/macOS instructions (e.g., file paths like '/tmp/json.txt').
- Add notes or examples for Linux/macOS users in PowerShell sections, including installation instructions for PowerShell Core.
- When showing file paths, use both Windows and Linux/macOS formats, or use environment variables to indicate cross-platform compatibility.
- Consider listing Azure CLI examples before PowerShell, as CLI is more universally available across platforms.
- Add troubleshooting or FAQ sections for common Linux/macOS issues (e.g., authentication, file permissions).
Create Pull Request