Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Bash and PowerShell examples for every command, ensuring parity between Linux/macOS and Windows users. However, PowerShell examples are given equal prominence as Bash, and in some cases, Windows-centric terminology (e.g., 'PowerShell') is used. There are no Linux-specific tools, troubleshooting steps, or notes, and the examples are always split between Bash and PowerShell, with no explicit prioritization of Linux/macOS workflows. The documentation does not mention or recommend Linux-native patterns, nor does it address potential differences in behavior or troubleshooting for Linux users.
Recommendations
- Add a note clarifying that Bash examples are suitable for Linux/macOS, and PowerShell for Windows, to help users choose the correct tab.
- Include troubleshooting tips or notes for Linux/macOS users, especially around file permissions, shell differences, or Azure CLI installation.
- Consider providing a default example (Bash) first, as Azure CLI is most commonly used in Bash on Linux/macOS.
- Mention any platform-specific caveats, such as differences in environment variable syntax or CLI behavior.
- Ensure parity in documentation by occasionally referencing Linux/macOS workflows, such as using native editors (vim, nano) or file system commands.