Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell is featured prominently as a scripting example, and in several places, the instructions and command examples are labeled as 'PowerShell' even when Azure CLI is also provided. The PowerShell tab is consistently listed before the Azure CLI tab, and the CLI examples are sometimes incorrectly labeled as 'PowerShell command'. There is no mention of Linux-specific shell environments (e.g., Bash), nor are there any examples tailored for Linux users (such as shell scripting, environment variables, or platform-specific notes). The documentation assumes familiarity with Windows-centric tools and patterns, potentially making it less approachable for Linux users.
Recommendations
- Correctly label Azure CLI examples as 'Bash' or 'Shell' where appropriate, and clarify that Azure CLI commands can be run on Linux, macOS, and Windows.
- Provide explicit Bash or shell script examples for Linux users, including notes on environment variable usage and command syntax differences.
- Alternate the order of PowerShell and Azure CLI tabs, or default to Azure CLI, which is cross-platform.
- Add notes or sections highlighting platform parity, such as how to perform steps on Linux, macOS, and Windows.
- Avoid referring to Azure CLI commands as 'PowerShell commands' and ensure accurate terminology throughout.
- Consider including screenshots or instructions for Linux terminal environments where relevant.
Create Pull Request