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_first
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation page demonstrates a Windows bias by providing extensive PowerShell examples and cmdlet references, mentioning PowerShell tools and patterns before Azure CLI equivalents, and omitting explicit Linux/bash examples. The CLI section is less detailed, and there are no bash or cross-platform shell examples, which may disadvantage Linux or macOS users.
Recommendations:
- Provide parallel bash/Azure CLI examples for all PowerShell commands, especially for tasks like obtaining ObjectId and deploying templates.
- List Azure CLI instructions before or alongside PowerShell instructions to avoid a 'Windows-first' impression.
- Include references to cross-platform tools (e.g., Azure CLI, REST API, or bash scripting) wherever PowerShell cmdlets are mentioned.
- Clarify that Azure CLI and ARM templates are fully supported on Linux/macOS and provide explicit instructions for those platforms.
- Expand the Azure CLI section to match the detail and guidance given in the PowerShell section, including parameter explanations and example outputs.
- Where GUID generation is needed, show how to generate GUIDs using Linux tools (e.g., uuidgen) in addition to PowerShell's New-Guid.
Create pull request