Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation demonstrates a Windows bias by consistently referencing PowerShell and Visual Studio Code as the primary local scripting environment, with instructions to run scripts in PowerShell locally. Although Azure CLI examples are provided (which are cross-platform), explicit instructions for running scripts locally mention PowerShell and Visual Studio Code, both of which are Windows-centric. There is no mention of Linux or macOS environments, nor are there examples or instructions tailored to those platforms. The documentation also omits guidance for Linux-specific shell environments (e.g., bash, zsh) and does not address potential differences in script execution or prerequisites for non-Windows users.
Recommendations
- Explicitly mention that Azure CLI commands can be run on Linux, macOS, and Windows, and provide instructions for running scripts in native Linux/macOS terminals (e.g., bash, zsh).
- Replace or supplement references to 'PowerShell locally in Visual Studio Code' with 'your preferred terminal or shell environment' and clarify cross-platform compatibility.
- Add notes or sections on prerequisites and setup for Linux/macOS users, such as installing Azure CLI, using bash scripts, and handling authentication.
- Include screenshots or examples from Linux/macOS environments where relevant, to ensure parity and inclusivity.
- Avoid implying that PowerShell is the default or only local scripting environment; present it as one option among several.
Create Pull Request