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
⚠️
windows_tools
Summary:
The documentation demonstrates a mild Windows bias, particularly in the 'Create the project' section, where Windows shells (cmd, PowerShell) are mentioned before Bash, and Visual Studio Code (a Microsoft tool) is suggested as the editor without mentioning alternatives. However, most commands and instructions are cross-platform, and Linux is not excluded, but Windows environments are prioritized in the order of mention.
Recommendations:
- When listing console options, use neutral or alphabetical order (e.g., 'Bash, cmd, or PowerShell') or simply say 'in a terminal' to avoid prioritizing Windows shells.
- When suggesting editors, mention alternatives to Visual Studio Code (e.g., 'Open the project in your preferred code editor, such as Visual Studio Code, Atom, or Sublime Text').
- Explicitly state that all commands are cross-platform and work on Windows, Linux, and macOS.
- Where environment variable instructions are given, clarify any OS-specific differences (e.g., how to set environment variables in Bash vs. PowerShell/cmd).
- Include example output or screenshots from both Windows and Linux terminals, if possible, to reinforce cross-platform parity.
Create pull request