Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation demonstrates a mild Windows bias by listing Windows installation instructions for Azure CLI before Linux/macOS, using PowerShell as the first example in code tabs, and referencing Windows-specific shell behaviors. Visual Studio Code is presented as the editor without mention of Linux/macOS alternatives or considerations. While Azure CLI examples are written for Bash, PowerShell is given equal or slightly more prominence, and some notes specifically address Windows shell differences.
Recommendations
- List installation instructions for Azure CLI in a neutral order (e.g., Linux, macOS, Windows) or group them together.
- Present Azure CLI (Bash) examples first in code tabs, as it is cross-platform, and PowerShell second.
- Add explicit notes or examples for macOS/Linux users regarding file paths, shell behaviors, and editor usage.
- Mention that Visual Studio Code is available on Linux/macOS, or suggest other cross-platform editors.
- Avoid Windows-centric language (e.g., 'workstation') and clarify instructions for all OSes.
- Where shell differences exist, provide clear guidance for Linux/macOS users, not just Windows users.
Create Pull Request