Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides configuration instructions for customer-managed keys in Azure API for FHIR, with examples using Azure Portal, PowerShell, Azure CLI, and ARM templates. However, PowerShell is featured prominently, both as a dedicated section and as the only example for ARM template deployment. There are no explicit Linux shell (bash) or cross-platform scripting examples, and PowerShell deployment is shown before CLI. This may create a perception that Windows or PowerShell is preferred or required, despite Azure CLI being cross-platform.
Recommendations
- Add bash (Linux shell) examples for ARM template deployment, e.g., using 'az deployment group create' or 'az resource group deployment'.
- Ensure Azure CLI examples are given equal prominence and shown before or alongside PowerShell examples.
- Clarify that both PowerShell and CLI are cross-platform, and explicitly mention Linux/macOS compatibility.
- Where possible, provide instructions for using bash scripts or Linux-native tools for deployment.
- Review and balance the order of examples so that Windows-specific tools (PowerShell) do not appear before cross-platform alternatives.
Create Pull Request