Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
🔧
Windows Tools
Summary
The documentation exclusively uses PowerShell scripts and the Az PowerShell module for all steps, including authentication, request construction, and REST API invocation. No examples are provided for Linux/macOS users (e.g., Bash, curl, Azure CLI), and Windows tools and patterns are referenced throughout without mention of cross-platform alternatives. This creates friction for non-Windows users and may prevent them from following the quickstart without significant adaptation.
Recommendations
- Add equivalent examples using Bash and curl for Linux/macOS users.
- Include Azure CLI commands for authentication and REST API invocation, which are cross-platform.
- Clearly indicate that PowerShell examples are Windows-centric and provide links or instructions for installing PowerShell Core on Linux/macOS if PowerShell must be used.
- Present examples for both Windows and Linux/macOS side by side, or at least alternate which platform is shown first.
- Mention that the Az PowerShell module is available for PowerShell Core on Linux/macOS, but also provide native Bash/curl/CLI alternatives.