About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
missing_linux_example
⚠️
windows_tools
⚠️
windows_first
Summary:
The documentation demonstrates a strong Windows bias by exclusively providing PowerShell scripts and instructions, with no mention of Bash, shell scripts, or cross-platform alternatives. All automation and deployment steps are described using PowerShell, which is traditionally associated with Windows environments, and there are no Linux-specific or cross-platform examples. The use of PowerShell as the only scripting language and the absence of any reference to Linux-native tools or commands may hinder users working in Linux-based CI/CD environments.
Recommendations:
- Provide equivalent Bash or shell script examples for deploying policies, ensuring Linux users can follow along without needing PowerShell.
- Explicitly mention that PowerShell Core is cross-platform and provide guidance for installing and running scripts on Linux/macOS, if PowerShell must be used.
- Include notes or sections on how to adapt the deployment process for Linux agents in Azure Pipelines, such as using Bash tasks or alternative scripting languages.
- List both Windows and Linux prerequisites, including any required tools or dependencies for each platform.
- Where possible, use platform-agnostic language and tools, or clearly indicate when a step is specific to Windows or PowerShell.
Create pull request