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
⚠️
windows_tools
⚠️
windows_heavy_examples
Summary:
The documentation consistently presents Windows examples and workflows before Linux equivalents, both for external devices and Azure VMs. It references Windows-specific tools (e.g., Command Prompt, 'tracert') and provides more detailed instructions for Windows (e.g., using the Search taskbar to open cmd). The prerequisite section links only to creating a Windows VM, omitting a Linux VM quickstart. While Linux instructions are present, they are generally less detailed and always follow Windows instructions.
Recommendations:
- Alternate the order of Windows and Linux instructions in each section, or present them side-by-side to avoid Windows-first bias.
- In the prerequisites, provide links to both Windows and Linux VM creation guides.
- Ensure parity in the level of detail for both Windows and Linux instructions (e.g., explain how to open a terminal in Linux as thoroughly as for Windows).
- When referencing tools, mention both Windows and Linux equivalents together (e.g., 'tracert (Windows) or traceroute (Linux)').
- Consider using neutral language and headings, such as 'On Windows' and 'On Linux', rather than always leading with Windows.
- Where possible, provide generic instructions first, then platform-specific details.
Create pull request