Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a strong Windows bias by exclusively providing command-line examples using PowerShell and referencing Windows-centric tools and patterns. There are no CLI or scripting examples for Linux/macOS users (e.g., Bash, Azure CLI), and the installation instructions and troubleshooting steps focus on PowerShell modules and execution policies, which are specific to Windows environments. The documentation does not mention or prioritize Linux or cross-platform alternatives, making it less accessible to non-Windows users.
Recommendations
- Add equivalent examples using Azure CLI (az) commands, which are cross-platform and widely used on Linux/macOS.
- Include Bash shell scripting examples for common tasks, such as project creation, viewing, editing, and deletion.
- Clarify that PowerShell Core (pwsh) is available on Linux/macOS, and provide installation instructions for those platforms.
- Mention and demonstrate usage of REST API or ARM templates for users who prefer platform-agnostic automation.
- Reorder examples so that cross-platform solutions (Azure CLI, REST API) are presented before or alongside PowerShell examples.
- Explicitly state platform compatibility for each tool and example, helping users understand which instructions apply to their environment.
Create Pull Request