About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation provides both Bash and PowerShell examples for Azure CLI commands, but the PowerShell (Windows) examples are given immediately after the Bash ones, and are explicitly labeled as 'Formatted for PowerShell.' There is no explicit mention of Linux or macOS environments, and the Bash examples are not clearly labeled as 'Linux/macOS.' The documentation does not provide parity in guidance or troubleshooting for Linux users, and the structure may imply a Windows-first approach.
Recommendations:
- Explicitly label Bash examples as 'Linux/macOS' and PowerShell examples as 'Windows' to clarify platform relevance.
- Present Bash (Linux/macOS) examples before PowerShell (Windows) examples to avoid a Windows-first impression.
- Add a brief note at the start of the CLI section explaining which example to use based on the user's operating system.
- Ensure troubleshooting tips or environment-specific notes are included for both Windows and Linux/macOS users.
- Consider providing a tabbed interface for Bash and PowerShell examples, so users can easily select their platform.
Create pull request