Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. Many examples and workflow steps reference PowerShell, AzPowershell, and Windows-centric tools (e.g., Azure PowerShell, PowerShell@2, scriptType: 'pscore'). While CI examples use 'runs-on: ubuntu-latest', the authentication and setup steps often default to PowerShell or Windows-specific patterns. Linux/macOS equivalents (e.g., Bash, Azure CLI) are not provided or are mentioned after Windows tools. There are no explicit Linux/macOS command-line examples for authentication or setup, and PowerShell is assumed for scripting in Azure Pipelines.
Recommendations
- Provide equivalent Bash/Azure CLI examples for authentication and setup steps, especially for Linux/macOS users.
- Explicitly mention that PowerShell steps can be replaced with Bash/Azure CLI on non-Windows runners.
- Add notes or code samples for Linux/macOS environments where PowerShell is not available or not preferred.
- Reorder examples so that cross-platform or Linux/macOS instructions are shown first or alongside Windows/PowerShell instructions.
- Clarify that 'scriptType: pscore' is for PowerShell Core and provide alternatives for Bash.
- Ensure all critical setup steps (authentication, package installation, running tests) have Linux/macOS parity.
Create Pull Request