Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates a strong Windows bias, primarily through the exclusive use of PowerShell for command-line examples and migration scripts. All CLI instructions and automation scripts are written in PowerShell, with no Bash, Azure CLI, or Linux-native alternatives provided. The prerequisites and troubleshooting sections also reference PowerShell modules and patterns, and Windows/PowerShell tooling is mentioned before Terraform. There are no Linux or cross-platform command-line examples, and no mention of Azure CLI or Bash scripting for these operations.
Recommendations
- Provide equivalent Azure CLI (az) examples for all PowerShell commands and scripts, ensuring Linux and macOS users can follow along without needing PowerShell.
- Include Bash script samples for migration and validation steps, or at least show how to use Azure CLI in shell scripts.
- Explicitly mention cross-platform support for all command-line operations, clarifying which methods work on Linux/macOS.
- Reorder sections to present cross-platform or neutral tooling (e.g., Azure portal, Azure CLI, Terraform) before Windows-specific tools like PowerShell.
- Add troubleshooting steps using Azure CLI, not just PowerShell.
- Update prerequisites to mention Azure CLI as an alternative to PowerShell for users on Linux/macOS.
Create Pull Request