Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. While most examples use Azure CLI (which is cross-platform), there are several places where Windows-specific shells (CMD, PowerShell) are mentioned before or instead of Linux equivalents. Formatting for parameters and variables is explained for Windows shells, but Linux/Bash examples are less detailed or appear after Windows instructions. There are no explicit PowerShell script blocks, but Windows command-line patterns and escaping are described in detail, while Linux/Bash usage is less emphasized.
Recommendations
- Ensure that Bash/Linux examples are provided alongside Windows CMD/PowerShell examples, especially when discussing parameter formatting and variable assignment.
- When describing shell-specific behaviors (such as escaping quotes or passing arrays), present Linux/Bash instructions first or equally with Windows instructions.
- Add explicit Bash and Linux shell examples for all command-line snippets, including variable assignment and parameter passing.
- Clarify which instructions apply to which platforms, and avoid assuming Windows as the default environment.
- Where possible, use platform-neutral syntax and highlight cross-platform compatibility.
Create Pull Request