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
Summary:
The documentation generally provides cross-platform instructions, but there are subtle signs of Windows bias. In several places, Windows command-line (Cmd) instructions are listed before Linux/macOS equivalents, and PowerShell is given its own dedicated section with examples, even when not strictly necessary. However, Linux/macOS instructions are present and functional, and the use of 'terminal or command prompt' is inclusive. The documentation does not omit Linux examples, but the ordering and emphasis sometimes favor Windows tools and patterns.
Recommendations:
- When providing command examples for multiple platforms, consider listing Linux/macOS instructions first or side-by-side with Windows, rather than defaulting to Windows-first ordering.
- Avoid giving PowerShell its own section unless it is truly necessary for the scenario; otherwise, group shell instructions by platform (e.g., Bash, Cmd, PowerShell) in a parallel structure.
- Ensure that all references to 'terminal or command prompt' clarify that any shell (Bash, Zsh, etc.) is supported, not just Windows Command Prompt or PowerShell.
- Where possible, use platform-agnostic commands or highlight differences only when strictly necessary.
- Review the use of file paths and environment activation commands to ensure Linux and macOS users are not confused by Windows-centric syntax.
Create pull request