Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a subtle Windows bias. While the main focus is on Azure CLI (which is cross-platform), several example variable assignments use PowerShell syntax (e.g., $DiskId = ...), which is not valid in Bash or Linux shells. There are no explicit Bash/Linux shell examples or notes for Linux users. Additionally, in the 'Next steps' section, Azure PowerShell is mentioned before Azure CLI, suggesting a Windows-first approach. There are no Linux-specific instructions or clarifications for cross-platform users.
Recommendations
- Provide both PowerShell and Bash/Linux shell examples for variable assignments and scripting steps. For example, show both $DiskId=... (PowerShell) and DiskId=... (Bash).
- Add a note clarifying that Azure CLI commands work on Windows, macOS, and Linux, and show how to adapt variable usage for each shell.
- In the 'Next steps' section, list Azure CLI before PowerShell, or present both equally, to avoid Windows-first ordering.
- Explicitly mention that all CLI commands are cross-platform, and provide troubleshooting tips for common shell differences (e.g., file redirection, quoting, environment variables).
- Where referencing scripts or automation, provide sample scripts for both PowerShell and Bash.
Create Pull Request