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 is heavily biased towards PowerShell, with all scripting and automation examples provided exclusively in PowerShell (.ps1) format. There are no equivalent Bash, Azure CLI, or Linux-native script examples. The prerequisites and instructions assume the use of PowerShell, and while there is a brief mention that PowerShell 7 can be installed on Linux and macOS, no Linux-specific guidance, troubleshooting, or alternative workflows are provided. This may create barriers for Linux users or those who prefer Bash/Azure CLI.
Recommendations:
- Provide equivalent migration scripts and instructions using Azure CLI and/or Bash, ensuring Linux users have a native option.
- Explicitly document how to run the provided PowerShell script on Linux (e.g., using pwsh), including any platform-specific prerequisites or troubleshooting tips.
- Add examples and screenshots from Linux environments (e.g., terminal output, file extraction commands) to demonstrate cross-platform support.
- Clarify in the prerequisites and throughout the guide that all steps are cross-platform, or provide separate sections for Windows and Linux/Mac users.
- Consider offering downloadable migration scripts in both PowerShell and Bash/Azure CLI formats.
Create pull request