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 demonstrates a Windows bias by prioritizing Azure PowerShell examples and references, mentioning PowerShell before Azure CLI, and providing detailed PowerShell instructions without equivalent Linux shell examples. While Linux is mentioned in the context of the Azure Guest Agent, there are no explicit Linux command-line examples or references to Linux-native tools, and PowerShell is presented as the primary method for inventorying and managing resources.
Recommendations
- Provide Linux shell (bash) command examples alongside PowerShell, especially for inventorying extensions and managing role assignments.
- Explicitly mention and demonstrate how to perform key steps (such as uninstalling the Connected Machine agent and managing VM extensions) on Linux systems, including relevant commands.
- Ensure that references to Azure CLI are given equal prominence and detail as PowerShell, and consider listing CLI examples before or alongside PowerShell to avoid Windows-first ordering.
- Include troubleshooting and migration guidance specific to Linux environments, such as handling Linux-specific agents and extensions.
- Add links to Linux documentation and best practices where Windows documentation is referenced.
Create Pull Request