Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation demonstrates Windows bias primarily by referencing PowerShell-based instructions for resource group creation (via includes), and by not providing explicit Linux (bash/CLI) alternatives alongside or before Windows examples. While the prerequisites mention OpenSSL on both Windows and Linux, the setup and resource creation steps rely on PowerShell scripts or instructions, and do not provide parity for Linux users. There is also a lack of explicit Linux shell/terminal examples for common Azure management tasks, and the documentation structure assumes a Windows-first workflow.
Recommendations
- For every PowerShell example or include, provide a corresponding Bash/Azure CLI example for Linux/macOS users.
- When referencing resource group creation or provider registration, show both PowerShell and Azure CLI commands side by side.
- Avoid assuming the user is on Windows; use neutral language and clarify when instructions are OS-specific.
- In the setup section, explicitly mention that all .NET and Azure CLI commands work cross-platform, and provide any OS-specific notes as needed.
- Audit all included content (such as 'includes/powershell-resource-group-create.md') to ensure Linux/CLI parity.
- Consider a 'Choose your environment' tabbed interface for code blocks (PowerShell, Bash, etc.) to improve accessibility for all users.
Create Pull Request