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:
⚠️
windows_first
⚠️
powershell_heavy
Summary:
The documentation provides both Bash and PowerShell examples for all Azure CLI commands, but consistently presents Bash first and then PowerShell. There is a note clarifying that examples can run in either shell and that separate examples are provided where variable syntax differs. No Windows-specific tools or patterns are exclusively mentioned, and there are no missing Linux examples. However, the explicit labeling of 'Formatted for PowerShell' and the inclusion of PowerShell-specific syntax throughout the page indicate a strong focus on Windows parity, possibly even a slight Windows-first bias due to the explicit PowerShell formatting, though Bash is always listed first.
Recommendations:
- Continue to provide both Bash and PowerShell examples, but clarify that Bash examples are suitable for Linux/macOS and PowerShell for Windows, to help users choose the right syntax.
- Consider adding a short section or table at the top summarizing which shell to use on which platform (e.g., Bash for Linux/macOS, PowerShell for Windows), to make it clearer for cross-platform users.
- If possible, provide a toggle or tabbed interface in the documentation to let users select their preferred shell (Bash or PowerShell), reducing visual clutter and making parity more obvious.
- Ensure that any references to file paths, environment variables, or shell-specific behaviors are clearly explained for both platforms.
- Maintain the order of examples (Bash first, then PowerShell) or alternate the order in different sections to avoid any perception of platform preference.
Create pull request