Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell is given its own tab alongside Azure CLI and Azure Portal, but there is no explicit mention of Linux or macOS-specific workflows, nor are Bash or shell examples provided. Visual Studio Code is referenced as the primary editor, which is cross-platform, but the guidance and examples (such as right-clicking and F2 hotkey) are more familiar to Windows users. The Azure CLI examples are platform-agnostic, but the absence of explicit Linux/macOS shell examples or notes about cross-platform usage may leave non-Windows users underserved.
Recommendations
- Add explicit Bash/shell examples for Linux/macOS users, especially where file redirection or command chaining is shown (e.g., use 'az group export --name ... > main.json' in a Bash context).
- Clarify that Azure CLI commands work identically on Windows, Linux, and macOS, and provide notes or tabs for Linux/macOS where appropriate.
- When referencing Visual Studio Code features, mention that these features are available on all supported platforms, and clarify any differences in keyboard shortcuts (e.g., F2 may differ on macOS).
- Include a section or tab for Linux/macOS users in the 'Export template and convert' section, or at least mention that the steps are the same across platforms.
- Avoid putting PowerShell before Bash/Azure CLI unless there is a specific reason; consider listing Azure CLI (cross-platform) first, then PowerShell, then Portal.
Create Pull Request