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
⚠️
missing_linux_example
⚠️
windows_first
Summary:
The documentation page demonstrates a strong Windows bias by exclusively using Azure PowerShell (Windows-centric) command-line examples and referencing Windows file paths (e.g., C:\CustomRoles\...). There are no examples or instructions for Linux users (e.g., using Azure CLI or Bash), and the documentation does not mention Linux tools or provide cross-platform guidance. The ordering and content assume a Windows environment by default.
Recommendations:
- Provide equivalent Azure CLI (az) command examples for all PowerShell commands, as Azure CLI is cross-platform and widely used on Linux and macOS.
- Use platform-neutral file paths in examples (e.g., ~/CustomRoles/ or /home/user/CustomRoles/ for Linux/macOS) or explicitly show both Windows and Linux paths.
- Add a section or callouts indicating that all steps can be performed on Linux/macOS, and provide any necessary differences or prerequisites.
- Reference both PowerShell and Bash (or shell) scripting where automation is discussed, or provide links to relevant cross-platform scripting documentation.
- Consider reordering or parallelizing example blocks so that Linux and Windows users see their options side by side, rather than Windows-first.
Create pull request