Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation is largely cross-platform, focusing on Azure CLI commands which work on Windows, Linux, and macOS. However, there are several instances where Windows-specific shells (CMD, PowerShell) are mentioned before Linux equivalents, and guidance for Windows users is more detailed. Bash examples are present, but Windows shell patterns and escaping are explained first and in more detail, which may create friction for Linux/macOS users.
Recommendations
- Present Linux/Bash and Windows/PowerShell examples side-by-side, or alternate which is shown first.
- Provide explicit examples for Linux/macOS shells where Windows-specific syntax or escaping is discussed.
- Clarify that Azure CLI commands are cross-platform and note any platform-specific differences in a dedicated section.
- Where variable assignment or parameter passing differs by shell, offer parallel examples for Bash, PowerShell, and CMD.
- Avoid assuming Windows as the default environment when discussing shell scripting or command-line usage.
Create Pull Request