About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
windows_tools
Summary:
The documentation demonstrates a Windows bias in several ways: variable assignment in CLI examples uses PowerShell syntax (e.g., $DiskId = ...), which is not portable to Linux/macOS shells; references to PowerShell and Windows tools appear in related content and permissions assignment sections; and there is a lack of explicit Linux/bash shell examples or guidance, which may confuse non-Windows users.
Recommendations:
- Provide all CLI variable assignment examples in both PowerShell and bash syntax, or use bash syntax by default for cross-platform compatibility (e.g., DiskId="..." instead of $DiskId = ...).
- Explicitly state that Azure CLI commands work on Windows, Linux, and macOS, and clarify any shell-specific syntax.
- Include Linux/bash-specific instructions or notes wherever PowerShell syntax or Windows tools are mentioned.
- In 'Next steps' and 'Related content', ensure parity by linking to Linux/bash-based guides (e.g., 'Restore Managed Disk using Azure CLI on Linux/macOS').
- Avoid using Windows/PowerShell variable assignment as the only example; if both are shown, present bash first or side-by-side.
Create pull request