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
Summary:
The documentation demonstrates a mild Windows bias: Windows and PowerShell examples are consistently presented first, and Windows-specific tools and environment variable syntax (PowerShell, cmd.exe) are described in greater detail or before Linux/macOS equivalents. Linux and macOS are included, but often as secondary considerations.
Recommendations:
- Alternate the order in which Windows and Linux/macOS examples are presented, or present them side-by-side to avoid prioritizing one platform.
- Provide equal detail for Linux/macOS shell usage (e.g., mention Bash or zsh explicitly, not just 'Linux').
- When discussing quoting or environment variables, clarify the shell context for each OS (e.g., Bash for Linux/macOS, PowerShell and cmd.exe for Windows) and provide parallel examples.
- Include a general, platform-agnostic example first, followed by OS-specific notes if needed.
- Avoid using Windows-specific terminology (like %USERPROFILE%) without immediately providing the Linux/macOS equivalent in the same sentence.
Create pull request