Document Details
Scenario Migrate To Azure
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
missing_linux_example
Summary
The documentation frequently references Azure PowerShell commands and workflows, often listing PowerShell before Azure CLI. Examples and instructions for inventorying extensions and reviewing access rights are PowerShell-centric, with CLI mentioned but not exemplified. Export instructions (e.g., to CSV) are PowerShell-focused, and there is a lack of explicit Linux/macOS shell examples (e.g., Bash). While the Azure Guest Agent section does mention both Windows and Linux agents, most procedural steps and examples prioritize Windows/PowerShell tools.
Recommendations
- Provide Bash/Azure CLI examples alongside PowerShell for all relevant steps, especially for inventorying extensions and exporting data.
- Explicitly mention Linux/macOS workflows where applicable, such as uninstalling the Connected Machine agent or installing the Linux Guest Agent.
- Ensure that CLI and PowerShell instructions are presented with equal prominence, or group them by platform to avoid Windows-first ordering.
- Add notes or links for Linux/macOS users for steps that differ from Windows, such as file export formats and shell commands.
Create Pull Request