Bias Analysis
Detected Bias Types
windows_tools
powershell_heavy
windows_first
Summary
The documentation page contains evidence of Windows bias. In the 'Microsoft.Compute' section, the note on generalizing a virtual machine lists the PowerShell command (Set-AzVm -Generalized) before the Azure CLI equivalent (az vm generalize). Additionally, the only command-line examples given for updating tags on certain resources (e.g., IP groups) use Azure CLI, but there is a tendency to mention PowerShell or Windows-centric tools first. The documentation also references Windows-specific tools and resource types (e.g., AzureStackHCI, Windows365, DevelopmentWindows365) without equivalent Linux-focused examples or resources. There are no explicit Linux shell (bash) examples, and Windows-centric terminology and tools are mentioned more frequently and/or first.
Recommendations
- Ensure command-line examples are provided for both PowerShell and bash/Azure CLI, and alternate which is listed first.
- Include Linux-focused resource types and examples where relevant, or clarify parity.
- Avoid mentioning Windows tools or patterns exclusively; when referencing a Windows tool, provide the Linux equivalent in parallel.
- Audit documentation for resource types and features that may be Windows-centric and add notes or examples for Linux users.
- Where possible, use cross-platform terminology and avoid assuming a Windows environment.
Create Pull Request