Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a subtle Windows bias. While the main focus is on Azure CLI (which is cross-platform), variable assignment examples use PowerShell syntax (e.g., $DiskId = ...), which is specific to Windows and not valid in Bash or other Linux shells. There are no explicit Bash/Linux shell examples, nor are there notes about cross-platform differences. The 'Next steps' section lists Azure portal and PowerShell before CLI, reinforcing a Windows-first pattern. There is also a link to PowerShell-specific documentation for assigning permissions, but no equivalent Bash/Linux guidance.
Recommendations
- Replace PowerShell variable assignment examples (e.g., $DiskId = ...) with Bash-compatible syntax (e.g., DiskId=...) or provide both.
- Add explicit Bash/Linux shell examples alongside PowerShell where variables or scripting are involved.
- In 'Next steps', list CLI before PowerShell to avoid Windows-first ordering.
- Provide links to Linux/Bash-specific documentation for tasks like assigning permissions, or clarify that the CLI commands work identically on Linux/macOS.
- Add a note at the top clarifying that Azure CLI commands are cross-platform and can be run on Windows, Linux, and macOS.
Create Pull Request