Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page exhibits Windows bias primarily through the use of PowerShell syntax for all command-line examples (e.g., git, npm, npx), and by referring to 'terminal or command window' without clarifying platform differences. There are no explicit Linux/macOS shell examples (e.g., bash), nor are there instructions for platform-specific nuances (such as path separators or environment variable setting differences). The installation instructions for tools like Azure CLI, Git, and Visual Studio Code are generic but do not provide parity for Linux-specific installation or usage patterns.
Recommendations
- Provide both PowerShell/Command Prompt and Bash (Linux/macOS) examples for all CLI commands, using appropriate syntax for each platform.
- Clarify platform-specific terminology (e.g., 'terminal' for Linux/macOS, 'command prompt' for Windows) and mention any differences in usage.
- Include Linux/macOS installation instructions or links for prerequisites such as Azure CLI, Git, and Visual Studio Code.
- Show how to set environment variables in both Windows (set/setx) and Linux/macOS (export) contexts.
- Use neutral shell syntax (e.g., $ for shell prompts) or provide tabs/switchers for platform-specific instructions.
Create Pull Request