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
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias by providing extensive Azure PowerShell examples and referencing PowerShell-specific modules and commands. PowerShell is a Windows-centric tool, and there are no equivalent Linux shell (bash) or cross-platform scripting examples. In several places, PowerShell instructions are given before or in more detail than Azure CLI, and there is no mention of Linux-specific tools or patterns. The documentation lacks explicit Linux shell (bash) or cross-platform scripting examples, which may disadvantage Linux users.
Recommendations:
- Add bash (Linux shell) examples for all command-line operations, especially for token retrieval and identity management.
- Ensure Azure CLI examples are complete and presented before or alongside PowerShell examples, as Azure CLI is cross-platform.
- Avoid using PowerShell-specific syntax or modules in generic command-line examples; provide alternatives where possible.
- Explicitly mention that all Azure CLI commands work on Linux, macOS, and Windows, and provide sample shell scripts for Linux users.
- Where PowerShell is referenced, clarify its availability on Linux and macOS, or provide equivalent bash commands.
- Audit for any references to Windows-only tools or patterns and provide Linux/macOS equivalents.
Create pull request