Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides detailed instructions and examples for both Azure CLI and Azure PowerShell, but the PowerShell section is more extensive, with additional setup steps, module installation, and resource provider registration guidance. PowerShell (a Windows-centric tool) is given a prominent and detailed treatment, and Windows-specific patterns (e.g., execution policy, PowerShell version checks) are included. There is no mention of Linux-specific shell usage (e.g., bash), nor are there examples tailored for Linux environments, such as shell variable syntax or installation steps for CLI on Linux. The CLI example uses variable syntax ($var) that is PowerShell-style, not bash/zsh, which may confuse Linux users.
Recommendations
- Add explicit bash/zsh examples for Azure CLI, using Linux shell variable syntax (e.g., storageMoverName="..."), and show commands as they would be run on Linux/macOS.
- Include installation instructions for Azure CLI on Linux and macOS, or link to them.
- Clarify that PowerShell instructions are primarily for Windows users, and provide parity for Linux/macOS users where possible.
- Avoid using PowerShell variable syntax in CLI examples; use cross-platform shell syntax or provide both.
- Mention any platform-specific requirements or differences (e.g., module installation, execution policy) for Linux/macOS users.
Create Pull Request