Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides detailed PowerShell examples for authenticating and invoking REST API calls, with no equivalent examples for Linux/macOS users (e.g., Bash, curl, or other cross-platform tools). PowerShell is recommended as the main tool for beginners, and Windows-centric cmdlets are used exclusively in code samples. This creates friction for Linux/macOS users who may not have PowerShell installed or prefer native tools.
Recommendations
- Add equivalent Bash/curl examples for authenticating and making REST API calls.
- Mention cross-platform tools (e.g., curl, httpie, ARMClient) alongside PowerShell, not just as an aside.
- Present examples for both Windows and Linux/macOS users, or use a neutral tool first (e.g., curl), then show PowerShell as an alternative.
- Clarify that PowerShell Core is available cross-platform, but provide installation instructions or alternatives for users who do not wish to use PowerShell.
Create Pull Request