About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation page demonstrates a bias toward Windows and PowerShell by providing only PowerShell-based command-line examples for configuring Application Gateway with Key Vault certificates. There are no equivalent Azure CLI (cross-platform) or Bash/Linux shell examples. The instructions and code samples assume the use of PowerShell, which is most commonly associated with Windows environments, and the 'Next steps' section links exclusively to a PowerShell guide. This may hinder Linux or macOS users who prefer or require CLI/Bash-based workflows.
Recommendations:
- Add equivalent Azure CLI (az) command examples alongside PowerShell for all configuration steps, especially for referencing Key Vault secrets and managing Application Gateway.
- Explicitly mention that all steps can be performed on Linux/macOS using Azure CLI or Bash, and provide links to relevant documentation.
- In the 'Next steps' section, include links to guides for Azure CLI and ARM/Bicep templates, not just PowerShell.
- Where possible, provide Bash script snippets or instructions for common Linux workflows (e.g., using environment variables, jq for JSON parsing, etc.).
- Ensure that references to tools and commands are cross-platform or, if not, that alternatives are clearly documented.
Create pull request