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
⚠️
missing_linux_example
Summary:
The documentation shows some Windows bias in the ordering and detail of examples. Windows prerequisites are listed before Linux, and the Windows section is more detailed (e.g., specifying Visual Studio and CMake installation options). The repository cloning example uses Windows command prompt syntax (git clone in a code block labeled 'cmd'), and there are no explicit Linux shell equivalents. Output folder locations are described for both OSes, but the Windows path is emphasized. There are no PowerShell-specific commands, but the overall structure and example ordering favor Windows users. Some Linux-specific details (like package manager alternatives for non-Ubuntu distros) are missing.
Recommendations:
- Alternate the order of Windows and Linux instructions or present them side-by-side to avoid implicit prioritization.
- Provide equivalent Linux shell commands and examples wherever Windows commands are shown, including repository cloning and file path references.
- Expand Linux prerequisites to mention common distributions and alternatives to apt (e.g., yum, dnf, zypper).
- Ensure all code snippets and file path references are shown for both Windows and Linux, using appropriate syntax and conventions.
- Where possible, use cross-platform tools and commands (e.g., generic git, cmake, make) and clarify any OS-specific steps.
- Add troubleshooting tips or notes for common Linux issues (e.g., permissions, library paths) to match the detail given for Windows.
Create pull request