Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page primarily describes backing up Azure Managed Disks using the Azure portal, which is cross-platform. However, when mentioning automation and scripting, PowerShell is listed first and more prominently than Azure CLI. There are references to PowerShell scripts for automating backup across subscriptions, but no explicit Linux/macOS shell examples or guidance. The CLI is mentioned, but not as the primary or first example. No Linux-specific tools or workflows are described, and there is no parity in example scripts for Linux users.
Recommendations
- Present Azure CLI examples alongside PowerShell, or even before PowerShell, to ensure Linux/macOS users have clear guidance.
- Explicitly state that all portal instructions are OS-agnostic, and provide links to CLI and REST API guides for users who prefer command-line automation.
- Add sample bash scripts or CLI commands for common tasks, such as cross-subscription backup configuration.
- Avoid listing PowerShell before CLI unless there is a technical reason; alternate order or present both equally.
- Include a note clarifying that PowerShell is available on Linux/macOS, but CLI may be more familiar to non-Windows users.
Create Pull Request