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 is heavily biased towards Windows environments, specifically PowerShell. All scripting and automation examples are provided exclusively in PowerShell, with no mention of Bash, shell scripts, or cross-platform alternatives. The instructions assume the use of PowerShell and Windows-style tooling throughout, with no guidance for Linux or macOS users. This could hinder adoption or create confusion for developers working in non-Windows environments.
Recommendations:
- Provide equivalent Bash or shell script examples for deploying policies, alongside the PowerShell script.
- Explicitly mention that the process can be performed on Linux/macOS agents and provide any necessary adjustments (e.g., file paths, script execution).
- Include guidance on installing required tools (such as PowerShell Core) on Linux/macOS, or clarify if the script requires Windows PowerShell-specific features.
- Show how to configure Azure Pipelines to use a Linux agent and run the deployment script, either via Bash or PowerShell Core.
- Consider using cross-platform scripting languages (e.g., Python) for automation examples, or at least acknowledge alternatives.
- Add a section or callout for Linux/macOS users, highlighting any differences or additional steps required.
Create pull request