This page contains Windows bias

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
⚠️ windows_first
⚠️ missing_linux_example
⚠️ windows_tools
Summary:
The documentation is heavily biased towards Windows and PowerShell environments. All command-line examples use PowerShell cmdlets, and there are no equivalent instructions or examples for Linux users (e.g., using Azure CLI, Bash, or cross-platform scripting). The documentation assumes the use of PowerShell consoles and Windows-specific tools, and there is no mention of how to perform these tasks on Linux or macOS. The only supported runbook type for source control integration is PowerShell 5.1, which is Windows-only, further reinforcing the Windows-centric approach.
Recommendations:
  • Provide equivalent examples using Azure CLI (az) commands, which are cross-platform and commonly used on Linux and macOS.
  • Explicitly state the platform limitations (e.g., that PowerShell 5.1 is Windows-only) and provide guidance for users on other platforms.
  • Include Bash or shell script examples for common tasks, such as assigning roles or configuring source control.
  • Mention and document any Linux/macOS-compatible alternatives for tasks currently shown only with PowerShell.
  • Clarify whether source control integration is possible with Python or other cross-platform runbook types, and if not, explain the roadmap or alternatives.
  • Add troubleshooting and encoding guidance relevant to Linux/macOS editors and environments, not just those focused on Windows/PowerShell.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-08-17 00:01 #83 in_progress ✅ Clean
2025-07-13 21:37 #48 completed ❌ Biased
2025-07-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

New-AzRoleAssignment ` -ObjectId <automation-Identity-Object(Principal)-Id> ` -Scope "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}" ` -RoleDefinitionName "Contributor"