Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. Migration instructions are provided for the Azure portal (GUI), Azure PowerShell, and Azure CLI. The PowerShell example is detailed and presented before the CLI example. The CLI example is labeled as 'powershell' in the code block, and uses variable syntax ($var) that is typical for PowerShell, not Bash, which may confuse Linux/macOS users. No explicit Bash/Linux shell example is provided, and there is no mention of Linux-specific tools or patterns. The documentation assumes familiarity with PowerShell and Windows-centric workflows, potentially creating friction for Linux/macOS users.
Recommendations
- Provide explicit Bash/Linux shell examples for Azure CLI commands, using correct Bash variable syntax (e.g., $resourceGroup without curly braces, or using export).
- Ensure code blocks for CLI examples are labeled as 'bash' or 'sh' rather than 'powershell' when appropriate.
- Add notes clarifying that Azure CLI works cross-platform and provide any OS-specific instructions if needed.
- Consider presenting CLI (cross-platform) examples before PowerShell (Windows-centric) examples to reduce perceived bias.
- Mention Linux/macOS compatibility in migration steps and highlight any differences or prerequisites for those platforms.
Create Pull Request