Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page exclusively uses Azure PowerShell for all automation and scripting examples, with no mention of Azure CLI, Bash, or cross-platform alternatives. The prerequisites and instructions assume PowerShell is installed and provide Windows-centric commands (e.g., checking PowerShell version in a command prompt). There are no Linux-specific instructions, nor any examples using tools or patterns common to Linux environments. The documentation implicitly prioritizes Windows and PowerShell, potentially excluding or inconveniencing Linux and macOS users.
Recommendations
- Add equivalent Azure CLI (az) examples for all resource creation, domain management, and DNS configuration steps, as Azure CLI is cross-platform and widely used on Linux.
- Include instructions for installing and using PowerShell Core (pwsh) on Linux and macOS, or clarify that the scripts work on PowerShell Core, not just Windows PowerShell.
- Provide prerequisite checks and environment setup steps for Linux and macOS (e.g., checking PowerShell Core version, using Bash or zsh).
- Mention and link to Azure CLI documentation as an alternative to PowerShell, and explain when users might prefer one over the other.
- Where possible, use generic, cross-platform language (e.g., 'terminal' instead of 'command prompt') and avoid assuming a Windows environment.
Create Pull Request