Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page is heavily biased toward Windows and PowerShell usage. All code examples for enabling and using managed identities, assigning roles, and accessing resources are provided in PowerShell, with only a single Python example (which is not Linux-specific and is generic). There are no Bash, CLI, or Linux shell examples, and Windows tools and paths are mentioned first and more frequently. The prerequisites and instructions consistently reference PowerShell modules and Windows file paths before their Linux equivalents, and REST API usage is demonstrated via PowerShell rather than curl or other cross-platform tools.
Recommendations
- Add equivalent Azure CLI and Bash examples for all PowerShell code blocks, especially for enabling managed identity, assigning roles, and accessing resources.
- Include Linux-specific instructions and examples, such as using curl for REST API calls and referencing Linux file paths and environment variables.
- Present Windows and Linux prerequisites and instructions in parallel, rather than listing Windows first or exclusively.
- Provide Python and/or Bash runbook examples that demonstrate managed identity usage on Linux Hybrid Runbook Workers.
- Reference cross-platform tools and patterns (e.g., Azure CLI, REST via curl) before or alongside Windows/PowerShell tools.
- Clarify where instructions or code are platform-specific, and offer alternatives for both Windows and Linux users.
Create Pull Request