Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by presenting all command-line examples using PowerShell syntax (e.g., 'cd', 'git clone', 'npm install') without mentioning Linux/macOS shell equivalents. The use of 'powershell' code blocks and terminology like 'command window' and 'terminal' is ambiguous, but the examples are written in a way most familiar to Windows users. There are no explicit Linux/macOS instructions or screenshots, and installation/usage patterns (such as Azure CLI and authentication) do not clarify cross-platform differences.
Recommendations
- Provide Linux/macOS shell examples (e.g., bash/zsh) alongside PowerShell commands, using appropriate code block annotations.
- Clarify that all CLI commands work on Linux/macOS and note any platform-specific differences.
- Include screenshots or instructions for Linux/macOS environments where relevant (e.g., terminal usage, file paths).
- Explicitly mention that tools like Azure CLI, Git, and npm are cross-platform and provide links to Linux/macOS installation guides.
- Avoid using only PowerShell code blocks; use 'shell' or 'bash' where appropriate, or show both.
Create Pull Request