Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for authentication, but PowerShell is given equal prominence to CLI, despite being Windows-centric. Most command examples are cross-platform (Azure CLI, Docker), but PowerShell examples are included throughout, and in some cases, CLI and PowerShell are presented as equivalent options. There is no explicit mention of Linux/macOS shell usage (e.g., Bash), and the order of examples often lists PowerShell alongside or immediately after CLI, rather than prioritizing cross-platform tools. There are no Linux-specific authentication patterns or troubleshooting notes, and the 'Next steps' section links to PowerShell and CLI guides, but not to Linux/macOS shell-specific guides.
Recommendations
- Prioritize Azure CLI and Docker examples, as these are cross-platform, and list them before PowerShell examples.
- Explicitly mention that Azure CLI and Docker commands work on Linux/macOS, and provide sample Bash syntax where appropriate (e.g., environment variable usage, piping).
- Add troubleshooting notes or tips for Linux/macOS users, such as file permission issues with Docker config, or differences in environment variable syntax.
- Consider adding a 'Linux/macOS authentication' section or callout to reassure non-Windows users of parity.
- Review the 'Next steps' section to include links to Linux/macOS getting started guides, if available.