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 exhibits a Windows bias by referencing Windows-specific tools and workflows first, such as PowerShell for VM creation, and providing detailed steps or links for Windows (e.g., OS disk swap) without equivalent Linux guidance. Linux-specific instructions are minimal and appear later in the document, with only a brief mention of reinstalling the ADE extension for Linux VMs. There are no Linux CLI or automation examples, and Windows-centric links are used for general VM operations.
Recommendations:
- Provide equivalent Linux CLI (e.g., Azure CLI, Bash) examples alongside or before PowerShell examples for VM creation and disk swap operations.
- Include detailed, step-by-step instructions for restoring and re-encrypting Linux VMs, not just a brief note.
- Link to both Windows and Linux documentation for OS disk swap and other VM management tasks.
- Ensure that automation and scripting examples are cross-platform (PowerShell and Bash/Azure CLI) to support both Windows and Linux administrators.
- Review the order of presentation to avoid always listing Windows tools or workflows first; consider parallel presentation or alternating order.
Create pull request