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
⚠️
missing_linux_example
Summary:
The documentation page demonstrates a Windows bias by referencing PowerShell and Windows-centric tools before Linux equivalents, and by omitting explicit Linux/Unix command-line examples. The only explicit tooling reference for assigning permissions points to a PowerShell-based guide, and the 'Next steps' section lists PowerShell before CLI, which is more cross-platform. There are no Linux-specific instructions or examples, and the documentation does not mention Bash, shell scripting, or Linux-native tools for interacting with the REST API.
Recommendations:
- Provide explicit examples using Azure CLI (az), which is cross-platform, for all operations currently referenced via PowerShell or the Azure portal.
- When referencing external guides (e.g., for assigning permissions), link to both PowerShell and CLI/Linux instructions, or to a neutral, cross-platform page.
- In the 'Next steps' section, list Azure CLI before or alongside PowerShell to avoid the impression of Windows-first guidance.
- Include example REST API invocations using curl or httpie, which are available on Linux, macOS, and Windows, to demonstrate true cross-platform usage.
- Where scripting is discussed, mention both PowerShell and Bash/shell scripting as options for automation.
- Audit all referenced links and ensure parity between Windows and Linux instructions throughout the documentation.
Create pull request