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
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias in several ways. PowerShell examples are given in detail and before Azure CLI examples, with file paths and usage patterns that are Windows-specific (e.g., 'c:\policies\coolAccessTier.json'). There are no explicit Linux or macOS command-line examples, nor are there notes about cross-platform differences or alternative shells. The documentation assumes familiarity with Windows tools and conventions, potentially making it less accessible to Linux users.
Recommendations:
- Provide Azure CLI examples before or alongside PowerShell examples, as Azure CLI is cross-platform and more familiar to Linux users.
- Include Linux/macOS file path examples (e.g., '/home/user/policies/coolAccessTier.json') wherever file paths are shown.
- Add notes clarifying that both Azure CLI and PowerShell are available on Windows, Linux, and macOS, and highlight any OS-specific considerations.
- Avoid using Windows-specific terminology (like 'right-click') without also mentioning keyboard or alternative methods for other platforms.
- Explicitly mention that the Azure portal and REST API are OS-agnostic, and provide guidance for users on non-Windows systems.
- Where possible, provide Bash shell equivalents for PowerShell commands, especially for scripting scenarios.
Create pull request