Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias primarily through the exclusive use of PowerShell for command-line examples and deployment instructions. All automation and scripting steps (such as deploying Resource Manager templates, setting access policies, and retrieving identities) are shown using PowerShell commands, with no equivalent Bash, Azure CLI, or Linux shell examples. Additionally, PowerShell is mentioned before Azure CLI in several places, and there are no explicit instructions or examples for Linux users, which may hinder parity and accessibility for cross-platform audiences.
Recommendations
- Provide equivalent Azure CLI (bash) examples alongside PowerShell commands for all automation and scripting steps, especially for template deployment and key vault access policy management.
- Clearly indicate which commands work cross-platform and which are Windows-specific, and recommend CLI usage for Linux/macOS users.
- Add a section or tabbed examples for Linux/macOS users, demonstrating how to perform the same tasks using Bash and Azure CLI.
- Review all references to PowerShell and ensure Azure CLI is presented with equal prominence, or in some cases, before PowerShell to avoid implicit Windows-first bias.
- Include troubleshooting and setup notes relevant to Linux environments, such as authentication, file paths, and shell syntax differences.
Create Pull Request