Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides both Windows and Linux instructions, but Windows-specific tools (PowerShell, Windows OpenSSH) are frequently mentioned first or in greater detail. PowerShell examples are given for most Azure CLI commands, and Windows OpenSSH installation is referenced with a dedicated link and tip. Linux instructions are present but often secondary, and some sections (like prerequisites and next steps) highlight Windows tools before Linux equivalents.
Recommendations
- Alternate the order of Windows and Linux instructions/examples so Linux is not always second.
- Provide Linux/macOS-specific command examples (e.g., bash, zsh) for Azure CLI usage, not just PowerShell adaptations.
- Include direct links to Linux OpenSSH documentation in 'Next steps', not just Windows.
- Where PowerShell is referenced, also provide equivalent bash/zsh syntax for Linux/macOS users.
- Clarify that Azure CLI commands work natively on Linux/macOS shells, and highlight any differences in quoting or syntax.
- Add troubleshooting links for Linux SSH/OpenSSH issues, not just Windows.
Create Pull Request