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 page demonstrates a mild Windows bias. In the 'Find resource provider' section, the PowerShell example is given immediately after the Azure CLI example, with no mention of Linux shell equivalents (such as Bash scripting or use of jq for output parsing). The PowerShell example assumes the use of Windows tooling. Additionally, the only OS-specific tool mentioned elsewhere is 'Azure Serial Console for Windows', and some resource providers reference Windows-specific services (e.g., Microsoft.WindowsIoT, Microsoft.WindowsDefenderATP), but there are no Linux-specific counterparts or examples. There are no Linux shell or scripting examples, and Windows tools are referenced before or instead of Linux alternatives.
Recommendations:
- Add Linux shell (Bash) examples alongside PowerShell, especially for common tasks like listing resources.
- When referencing OS-specific tools or services (e.g., Serial Console for Windows), provide parity by mentioning or linking to Linux equivalents (e.g., Serial Console for Linux).
- Ensure that scripting examples (such as Python) are presented as cross-platform, and clarify that Azure CLI is available on all major platforms.
- Where possible, balance the order of examples so that Windows and Linux users are equally represented (e.g., alternate the order of PowerShell and Bash examples, or present both together).
- Explicitly mention when a tool or service is Windows-only, and provide guidance for Linux users if available.
Create pull request