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
⚠️
missing_linux_example
Summary:
The documentation assumes a Windows development environment by default, provides only Windows (cmd) commands for setting environment variables and running commands, and does not include equivalent Linux/bash examples. While it mentions that steps can be performed on Linux, it does not provide explicit Linux instructions or command syntax, which may hinder Linux users.
Recommendations:
- Provide Linux/bash equivalents for all command-line instructions, especially for setting environment variables (e.g., export VAR=value).
- When showing command-line examples, present both Windows (cmd) and Linux (bash) commands side by side or in tabs.
- Avoid language such as 'the steps in this article assume a Windows development machine' unless absolutely necessary; instead, state that instructions are cross-platform and provide both sets of commands.
- Explicitly mention any OS-specific differences in steps, tools, or behaviors.
- Include screenshots or references to popular Linux editors or terminals where relevant, not just Visual Studio Code.
Create pull request