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:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation page demonstrates a subtle Windows bias. In the 'Next steps' section, Azure PowerShell is listed before Azure CLI, which is more cross-platform and widely used on Linux. Additionally, the only explicit link for assigning permissions refers to a PowerShell-based guide (backup-managed-disks-ps.md#assign-permissions), with no mention or example of using Azure CLI or other Linux-native tools for this step. No Linux- or Bash-specific command-line examples are provided, and the documentation does not clarify that all REST API operations are platform-agnostic or show how to use tools like curl or az CLI from a Linux shell.
Recommendations:
- When referencing command-line tools, always mention Azure CLI alongside or before PowerShell, as CLI is cross-platform and widely used on Linux.
- Provide explicit Linux/Bash/curl examples for REST API calls, demonstrating how to perform the same operations from a Linux environment.
- For permission assignment, link to both PowerShell and Azure CLI instructions, or provide a platform-neutral explanation with both command sets.
- Clarify in the introduction that the REST API is platform-agnostic and can be used from any OS, and provide example invocations using tools available on Linux.
- In 'Next steps', list Azure CLI before PowerShell, or group them together as 'Azure CLI/PowerShell' to avoid implying a Windows-first workflow.
Create pull request