Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides parity in certificate generation and web server configuration for both Windows and Linux, primarily using OpenSSL and including examples for IIS (Windows), Apache, and NGINX (Linux). However, in the section on uploading the root certificate to Application Gateway, only Azure PowerShell examples are given, with no Azure CLI or REST API equivalents. Additionally, the PowerShell sample uses Windows-style file paths and is presented before any mention of Linux alternatives, which may create friction for Linux/macOS users.
Recommendations
- Add Azure CLI and/or REST API examples for uploading the root certificate and configuring Application Gateway, using Linux-style file paths.
- Explicitly mention that Azure PowerShell is available cross-platform, but provide CLI commands for users who prefer native Linux tools.
- When showing file paths or commands, provide both Windows and Linux/macOS variants, or use generic paths.
- Consider listing Azure CLI examples before or alongside PowerShell to avoid Windows-first impression.