Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows-first bias in several areas. Windows operating systems are listed before Linux, and Windows-specific requirements (such as SSU and SHA-2 updates) are described in detail, while Linux instructions are less explicit. Azure PowerShell is repeatedly referenced as the primary automation tool, with Azure CLI explicitly marked as unsupported, which disadvantages Linux/macOS users. Disk and storage encryption features are described with Windows examples first, and troubleshooting/known issues are more detailed for Windows. There are no Linux shell or CLI examples, and Linux-specific automation or troubleshooting steps are less visible.
Recommendations
- Provide Linux shell (bash) and Azure CLI examples for all automation steps currently shown only with PowerShell.
- List Linux operating systems and features before or alongside Windows, rather than after.
- Include troubleshooting and upgrade instructions for Linux with the same level of detail as Windows.
- Clarify or expand support for Linux-native tools and workflows, such as Azure CLI, and document any workarounds for unsupported features.
- Ensure parity in documentation for encryption, disk management, and networking features between Windows and Linux.
- Add explicit guidance for Linux/macOS users where PowerShell is referenced, including alternatives or installation instructions.
Create Pull Request