Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation demonstrates a mild Windows bias. PowerShell is listed before Bash in prerequisites and examples, and Visual Studio Code is recommended as the terminal environment, which is more commonly used on Windows. The PowerShell example is presented before the Bash example, and the explanation of escaping syntax focuses on PowerShell specifics. There is no mention of native Linux terminals or editors, and the guidance assumes familiarity with Windows-centric tools.
Recommendations
- List Bash or native Linux shell options before PowerShell in prerequisites and examples.
- Include instructions for running commands in common Linux terminal environments (e.g., GNOME Terminal, Konsole) and editors (e.g., Vim, Nano), not just Visual Studio Code.
- Provide Linux-specific notes, such as file path conventions and environment setup.
- Balance the order of examples so that Bash/Linux commands are presented first or equally with PowerShell.
- Mention that Azure CLI and az rest work natively on Linux and macOS, not just in Git Bash or PowerShell.
- Clarify that Visual Studio Code is cross-platform, or suggest alternative editors for Linux users.
Create Pull Request