Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits a moderate Windows bias. Command-line examples for both PowerShell and Azure CLI are provided, but all sample commands use Windows-style paths (e.g., 'C:\>'), and installation instructions reference Windows conventions. PowerShell is presented before Azure CLI, and there are no explicit Linux/macOS instructions or examples (such as shell prompt styles, package manager installation commands, or notes about cross-platform usage). This may create friction for Linux/macOS users, especially those unfamiliar with Windows-centric tooling.
Recommendations
- Provide explicit Linux/macOS instructions for installing PowerShell modules and Azure CLI extensions (e.g., use 'pip', 'apt', or 'brew' where appropriate).
- Use generic shell prompts ('$' or '#') in CLI examples, or show both Windows ('C:\>') and Linux ('$') styles.
- Clarify that both PowerShell and Azure CLI are cross-platform, and link to platform-specific installation guides.
- Include notes about running commands on Linux/macOS, such as differences in authentication or environment setup.
- Present Azure CLI examples before or alongside PowerShell, as CLI is more commonly used on Linux/macOS.
Create Pull Request