Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation page primarily provides instructions for creating Azure Migrate projects via the Azure portal and REST API, which are cross-platform. However, in the section describing agentless dependency analysis enhancements, it instructs users to install the Azure CLI and then explicitly directs them to open PowerShell as Administrator to run CLI commands, without mentioning Linux/macOS terminals or shell alternatives. This creates a Windows-first impression and may confuse non-Windows users. No Linux/macOS-specific examples or instructions are provided, and PowerShell is referenced as the default shell for CLI usage.
Recommendations
- Explicitly mention that Azure CLI commands can be run in Bash, zsh, or other shells on Linux/macOS, not just PowerShell.
- Provide example CLI commands in both Windows (PowerShell) and Linux/macOS (Bash) contexts.
- Avoid language that assumes PowerShell is the default shell for all users.
- Add notes or links for installing and using Azure CLI on Linux/macOS.
- Where administrator privileges are required, clarify the equivalent steps for Linux/macOS (e.g., using sudo).
Create Pull Request