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 generally attempts to be cross-platform, but there are several areas where Windows-specific tools, shells, or patterns are given prominence or appear before Linux/macOS equivalents. PowerShell and Windows Command Prompt (Cmd) are often featured, sometimes before bash or Linux-native instructions. In addition, the use of 'command prompt' as a generic term can be confusing for Linux users, and some sections (such as virtual environment activation) provide more detailed or multiple Windows options compared to Linux/macOS.
Recommendations:
- Ensure that Linux/macOS instructions are always presented alongside Windows instructions, and avoid listing Windows options first by default.
- Use neutral terminology such as 'terminal' instead of 'command prompt' when referring to the shell, or clarify when a step is OS-specific.
- Where multiple shell options are shown (e.g., bash, Cmd, PowerShell), always include Linux/macOS bash first, or present all options in parallel tabs.
- For PowerShell-specific examples, provide equivalent bash or shell commands for Linux/macOS users where possible.
- Review all code snippets and instructions to ensure parity in detail and clarity for both Linux/macOS and Windows users.
- Consider adding a short section at the start clarifying that all steps are supported on Linux, macOS, and Windows, and that examples are provided for each.
Create pull request