Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation presents Windows-centric tools and workflows before their cross-platform equivalents. PowerShell is given as a primary example, and the Azure portal (which is most familiar to Windows users) is described first. While Azure CLI examples are provided and are cross-platform, there are no explicit Linux/macOS-specific instructions or notes, and PowerShell is presented before CLI. There are no references to Linux shell scripting, nor are there any mentions of Linux-specific tools or environments.
Recommendations
- Present Azure CLI examples before PowerShell, as Azure CLI is cross-platform and more familiar to Linux/macOS users.
- Explicitly mention that Azure CLI commands work on Linux/macOS and Windows, and provide any OS-specific notes if relevant.
- Include a brief note or section for Linux/macOS users, confirming that all steps are supported on their platforms.
- If possible, add bash/zsh shell scripting examples for common tasks, especially in sections where PowerShell scripts are shown.
- Ensure that screenshots and navigation instructions in the Azure portal are not Windows-specific (e.g., avoid references to Windows-only UI elements or paths).
Create Pull Request