Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation provides configuration instructions for customer-managed keys using the Azure portal, PowerShell, CLI, and ARM templates. However, PowerShell examples are given prominently, including for ARM template deployment, and there is no mention of Linux/macOS-specific shell commands (e.g., Bash). The PowerShell deployment script is shown without an equivalent Bash/Unix shell example, and PowerShell is referenced before CLI in several places. This creates friction for Linux/macOS users who may not use PowerShell.
Recommendations
- Add Bash or shell script examples for ARM template deployment using Azure CLI (e.g., az deployment group create).
- Present Azure CLI examples before PowerShell examples, or side-by-side, to emphasize cross-platform parity.
- Explicitly state that all CLI commands work on Linux/macOS, and provide any necessary platform-specific notes.
- If PowerShell is required for any step, clarify whether PowerShell Core is supported on Linux/macOS, or provide alternatives.
- Review and update images/screenshots to ensure they are not Windows-specific where possible.