Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation page demonstrates mild Windows bias. When listing prerequisites, both Azure CLI and Azure PowerShell are mentioned, but PowerShell is listed second and examples are provided for both. However, in the 'Insert Resource' section, Azure CLI and Azure PowerShell commands are shown in tabs, with CLI first, which is good parity. The documentation does not provide any Linux-specific instructions, screenshots, or troubleshooting steps, and all keyboard shortcuts are presented in Windows format (Ctrl+Shift+P, Ctrl+Z, etc.), with only one mention of Cmd for Mac. There are no references to Linux tools or shell environments, and no screenshots or examples show Linux desktops or terminals. The overall workflow assumes Visual Studio Code, which is cross-platform, but the presentation and examples lean toward Windows conventions.
Recommendations
- Add explicit instructions or notes for Linux users, such as alternative keyboard shortcuts (e.g., Ctrl vs Cmd, Alt vs Option).
- Include screenshots from Linux environments or clarify that the UI is similar across platforms.
- Provide troubleshooting steps or notes for common Linux-specific issues (e.g., file permissions, installation paths).
- Mention that Azure CLI is cross-platform and provide shell examples (bash/zsh) where relevant.
- Ensure that all examples and instructions are platform-neutral or provide tabs for Windows, Linux, and Mac where differences exist.
Create Pull Request