Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides examples for Azure CLI and Azure PowerShell, with the PowerShell section being notably detailed and including Windows-specific setup steps (e.g., execution policy, PowerShell version). The CLI example uses variable syntax ($var) that is PowerShell-specific and not valid in bash, which is the default shell on Linux/macOS. There are no explicit Linux/macOS shell examples, nor is there mention of Linux-specific considerations or parity in the setup instructions.
Recommendations
- Provide explicit bash shell examples for Azure CLI, using Linux/macOS-compatible variable syntax (e.g., storageMoverName="..." instead of $storageMoverName).
- Clarify that Azure CLI works cross-platform and show both Windows (cmd/PowerShell) and Linux/macOS (bash/zsh) example blocks.
- Add notes or sections for Linux/macOS users regarding environment setup, such as installing Azure CLI via package managers (apt, yum, brew) and any OS-specific prerequisites.
- Avoid using PowerShell variable syntax in CLI examples unless explicitly targeting PowerShell; use generic syntax for broader compatibility.
- Ensure that instructions for installing modules/tools are not Windows-centric and mention Linux/macOS equivalents where relevant.
Create Pull Request