Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a bias towards Windows environments and tooling. PowerShell and AzPowershell are used in CI examples, and Windows-centric tools (PowerShell, Azure PowerShell) are referenced for authentication and setup. There is a lack of explicit Linux shell (bash/sh) examples, and Windows tools are mentioned before their Linux equivalents, even in contexts (CI runners) that are cross-platform. The documentation does not provide parity for Linux-native commands or workflows, and assumes familiarity with Windows/PowerShell patterns.
Recommendations
- Provide equivalent bash/sh examples for all PowerShell commands, especially for CI/CD steps and authentication.
- Reference cross-platform Azure CLI commands before or alongside Azure PowerShell, especially for authentication and service principal creation.
- Explicitly mention Linux and macOS compatibility in setup instructions, and provide examples for these platforms.
- Avoid using Windows-specific terminology (e.g., 'AzPowershell') as the default; clarify when steps are platform-specific.
- Add a section or tab for Linux-first workflows, including common shell usage and troubleshooting tips for non-Windows environments.
Create Pull Request