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_tools
⚠️
missing_linux_example
⚠️
windows_first
Summary:
The documentation is heavily biased towards Windows and PowerShell. All migration steps, prerequisites, and automation are described exclusively using PowerShell scripts and modules, with explicit instructions to use an 'elevated PowerShell window.' There are no equivalent instructions or scripts for Linux or cross-platform environments, nor are alternative methods (such as Bash, Azure CLI, or Python scripts) provided. The documentation assumes the user is on Windows and does not address Linux or macOS users, except for a brief mention of Azure CLI in the discovery step.
Recommendations:
- Provide equivalent migration instructions using Azure CLI and/or Bash scripts that can be run on Linux and macOS.
- Offer a cross-platform version of the migration script (e.g., in Python or as an Azure CLI extension) and document its usage.
- Explicitly state platform compatibility for the provided scripts and offer guidance for non-Windows users.
- Include Linux/macOS-specific prerequisites and installation steps (e.g., how to install Azure CLI or PowerShell Core on Linux).
- Ensure that all screenshots and command prompts are not Windows-specific, or provide alternatives for other platforms.
- Reorder examples or provide parallel instructions so that Linux and cross-platform options are presented alongside or before Windows-specific ones.
Create pull request