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
⚠️
missing_linux_example
⚠️
windows_tools
⚠️
windows_first
Summary:
The documentation demonstrates a Windows bias by providing command-line examples exclusively in Azure PowerShell, with no equivalent Azure CLI (cross-platform) or Bash examples. The PowerShell examples and references are presented before any mention of cross-platform tools, and there are no Linux-specific instructions or screenshots. The documentation assumes familiarity with Windows-centric tools and patterns, such as PowerShell cmdlets, and omits guidance for users on Linux or macOS platforms.
Recommendations:
- Add Azure CLI examples alongside PowerShell for all command-line operations, as Azure CLI is cross-platform and widely used on Linux and macOS.
- Include Bash shell command examples where appropriate, especially for unlinking or deleting resources.
- Ensure that references to command-line tools do not assume a Windows environment; clarify that steps can be performed from any OS.
- Where screenshots are used, consider including examples from both Windows and Linux environments if UI differences exist.
- Reorder sections so that Azure CLI and PowerShell examples are presented together or in a neutral order, rather than PowerShell first.
- Explicitly mention that all operations can be performed from Linux, macOS, or Windows, and provide any OS-specific caveats if needed.
Create pull request