Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page exhibits a strong Windows bias, with all command-line and scripting examples provided exclusively in PowerShell. There are no bash, shell, or Linux/macOS-specific instructions, and file paths in JSON templates use Windows-style backslashes. The onboarding and configuration scripts are referenced as PowerShell (.ps1) files, with no mention of Linux-compatible alternatives. This creates friction for Linux/macOS users, who must adapt instructions and scripts themselves.
Recommendations
- Provide equivalent bash/shell examples for all PowerShell commands, using az CLI and compatible syntax.
- Offer onboarding scripts in cross-platform formats (e.g., bash, Python) or document how to run PowerShell scripts on Linux/macOS.
- Use platform-neutral file paths in JSON templates, or provide separate examples for Windows and Linux/macOS.
- Explicitly state OS requirements for scripts and tools, and link to instructions for installing PowerShell Core on Linux/macOS if required.
- Ensure that all steps can be completed on Linux/macOS, and highlight any platform-specific limitations.
Create Pull Request