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
Bias Types:
⚠️
powershell_heavy
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation demonstrates a strong bias toward Windows and PowerShell usage. All scripting and automation examples are provided exclusively as PowerShell scripts (.ps1), with no mention of Bash, CLI, or Linux-native alternatives. The prerequisites and instructions assume the use of PowerShell, and there are no Linux- or cross-platform-specific examples or guidance, despite PowerShell Core being cross-platform. The documentation also references Windows-centric tools and patterns, such as the .ps1 script and Windows-style command prompts, without clarifying or demonstrating usage on Linux or macOS.
Recommendations:
- Provide equivalent Bash or Azure CLI scripts/examples for Linux/macOS users, or at least mention how to run the PowerShell script on Linux/macOS using PowerShell 7.
- Clarify in the prerequisites and instructions that PowerShell 7 is cross-platform, and provide explicit instructions for installing and running the script on Linux and macOS.
- Add notes or sections that address common Linux/macOS environments, such as file extraction, script execution permissions (chmod +x), and how to invoke the script from a Linux shell.
- Where screenshots or command prompts are shown, include examples from both Windows and Linux terminals to demonstrate parity.
- If the migration process is only supported via PowerShell, explicitly state this limitation and provide a roadmap or alternatives for Linux users if possible.
Create pull request