Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides both Azure CLI and PowerShell examples for all operations, but PowerShell is featured equally or slightly more heavily, and is referenced in several key steps (e.g., accepting Marketplace terms, recreating VMs) as the primary method. There is a subtle Windows bias in the use of PowerShell and Windows-centric terminology, with no explicit mention of Linux shell scripting or Linux-specific tools. The documentation does not provide bash or shell script examples, nor does it discuss Linux-specific patterns or considerations beyond referencing Azure Disk Encryption for Linux VMs.
Recommendations
- Add bash/shell script examples alongside Azure CLI and PowerShell, especially for steps involving scripting or automation.
- Explicitly mention that Azure CLI commands can be run natively on Linux/macOS, and provide guidance for Linux users where appropriate.
- Where PowerShell is referenced as the primary method (e.g., accepting Marketplace terms), clarify that Azure CLI is cross-platform and provide equivalent CLI commands.
- Include notes or sections highlighting any Linux-specific considerations, such as file system permissions, environment variables, or differences in command-line usage.
- Review the order of examples to avoid always listing PowerShell first; alternate or lead with Azure CLI where possible, as it is more platform-neutral.
Create Pull Request