Bias Analysis
Detected Bias Types
powershell_heavy
missing_linux_example
windows_tools
windows_first
Summary
The documentation page demonstrates a Windows bias by exclusively providing Azure PowerShell commands for role assignment, without mentioning or providing equivalent Azure CLI or REST API examples that are more cross-platform and Linux-friendly. The instructions and tooling references are centered on PowerShell, which is traditionally a Windows tool, and there is no guidance for users on Linux or macOS systems. The documentation also refers to the Azure Portal UI, which is platform-agnostic, but the only automation example is Windows-centric.
Recommendations
- Provide equivalent Azure CLI commands for role assignment to Azure Cosmos DB, as Azure CLI is cross-platform and widely used on Linux and macOS.
- Include REST API examples for role assignment to support automation from any OS.
- Explicitly mention that PowerShell is available on Linux and macOS, but recommend Azure CLI for cross-platform compatibility.
- Add a section or note for Linux/macOS users, outlining steps and tools they can use to achieve the same outcome.
- Ensure that all code samples and instructions are presented in a way that does not assume a Windows environment.
Create Pull Request