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:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
windows_tools
Summary:
The documentation generally provides cross-platform OpenSSL instructions for certificate generation and covers web server configuration for both Windows (IIS) and Linux (Apache, NGINX). However, there is a Windows-first bias in several areas: (1) Windows tools and patterns (e.g., IIS, PowerShell, C:\ paths) are mentioned before Linux equivalents; (2) the Azure PowerShell example is provided in detail, but there is no equivalent Azure CLI (cross-platform) example; (3) references to editing the hosts file and certificate import are Windows-centric, with no Linux-specific guidance.
Recommendations:
- Provide Azure CLI examples alongside or before Azure PowerShell examples for uploading certificates to Application Gateway, as Azure CLI is cross-platform.
- When referencing file paths (e.g., C:\Users\...), include Linux path equivalents (e.g., /home/user/...).
- For instructions on importing root certificates into the trusted store, include Linux-specific steps (e.g., update-ca-certificates on Ubuntu) in addition to Windows instructions.
- When mentioning editing the hosts file, provide the Linux path (/etc/hosts) and editing instructions.
- Consider presenting web server configuration sections (IIS, Apache, NGINX) in a neutral or rotating order, or group them by platform to avoid implicit prioritization.
- Where possible, avoid assuming the user is on Windows, and explicitly state when steps differ between platforms.
Create pull request