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_tools
⚠️
windows_first
Summary:
The documentation provides extensive Azure PowerShell examples and references, with some CLI parity but no explicit Linux shell (bash) or cross-platform scripting examples. PowerShell is presented as a primary automation tool, and certain instructions (such as for user-assigned identities in Functions) are only available in PowerShell. There is no mention of Linux-specific tools, nor are bash or shell script examples provided. The CLI examples are present but sometimes marked as 'azurepowershell-interactive', which may confuse Linux users. The documentation implicitly assumes familiarity with PowerShell and Windows-centric tooling.
Recommendations:
- Add explicit bash/shell script examples for all CLI operations, ensuring parity with PowerShell instructions.
- Clarify that Azure CLI commands are cross-platform and provide Linux/macOS terminal usage notes where appropriate.
- Avoid labeling CLI examples as 'azurepowershell-interactive' when they are not PowerShell-specific.
- Where PowerShell is the only supported method (e.g., for Functions user-assigned identity assignment), explicitly state the lack of Linux-native support and provide workarounds or roadmap information.
- Include references to Linux-native tools or scripting environments where possible.
- Ensure that CLI and ARM template examples are presented before or alongside PowerShell examples to avoid a 'windows_first' impression.
Create pull request