Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation page for REST API Requests for the Run Command on Azure Arc-enabled Servers demonstrates a notable Windows bias. All example scenarios, scripts, and references are specific to Windows Server (e.g., Windows Server 2012/R2), using PowerShell cmdlets (New-NetFirewallRule) and Windows-specific tools (New-AzStorageBlobSASToken). There are no examples, scripts, or guidance for Linux Arc-enabled servers, nor any mention of Linux shell commands or tools. The documentation assumes a Windows context throughout, creating friction for Linux users who wish to use the REST API for remote command execution.
Recommendations
- Add parallel example scenarios for Linux Arc-enabled servers, such as configuring firewall rules using bash scripts or iptables.
- Include sample REST API payloads with Linux shell scripts (e.g., inline bash or referencing .sh files in blob storage).
- Mention Linux equivalents for generating SAS tokens (e.g., using Azure CLI az storage commands).
- Clarify in the introduction that the REST API supports both Windows and Linux servers, and provide links to Linux-specific documentation if available.
- Ensure references to tools and scripting languages are balanced between Windows and Linux contexts.
Create Pull Request