Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation presents Azure PowerShell (which is Windows-centric) examples before Azure CLI in each major section. PowerShell is referenced as the first option for scripting, and PowerShell-specific concepts (such as splatting) are explained in detail, while Bash/Linux equivalents are not. Visual Studio Code is recommended, but no mention is made of Linux-specific editors or shell environments. The CLI examples do use Bash syntax, but the overall structure and ordering favor Windows/PowerShell users.
Recommendations
- Alternate the order of PowerShell and CLI examples, or present CLI first to balance platform representation.
- Provide equivalent explanations for Bash/Linux scripting concepts (e.g., variable assignment, line continuation) where PowerShell splatting is explained.
- Explicitly mention that Azure CLI works cross-platform and provide guidance for Linux/macOS users (e.g., using native terminals, installation instructions for those platforms).
- Reference Linux-native editors (such as Vim, Nano, or Gedit) alongside Visual Studio Code, or clarify that VS Code is cross-platform.
- Add notes or tips for Linux/macOS users where Windows-specific behaviors or tools are discussed.
- Ensure that all examples and instructions are validated on Linux/macOS as well as Windows.
Create Pull Request