Document Details
Azure To Azure Common Questions
This page contains Windows bias
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
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation exhibits several forms of Windows bias: Windows-specific features (such as ADE and VSS) are described in detail, often before or instead of Linux equivalents. PowerShell is frequently referenced as the primary automation method, with no mention of Bash, CLI, or Linux-native tooling. Examples and instructions for Linux users are sparse or absent, and some features (e.g., shared disks) are explicitly unsupported for Linux VMs. Windows-centric terminology and tools are prioritized throughout, creating friction for Linux/macOS users.
Recommendations
- Provide equivalent Linux CLI or Bash examples alongside PowerShell instructions.
- Explicitly document Linux support and limitations for all major features, including disk encryption and shared disks.
- Reference Azure CLI and REST API methods where possible, not just PowerShell.
- Clarify when features are Windows-only, and suggest alternative approaches for Linux users.
- Include Linux-specific troubleshooting and automation guidance.
- Ensure that Linux-related documentation is as detailed and prominent as Windows guidance.
Create Pull Request
Clean