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 guidance for certificate generation using OpenSSL, which is available on both Windows and Linux. However, there is a noticeable Windows bias in several areas: (1) Windows tools and patterns (IIS, PowerShell, Windows file paths) are mentioned before or more prominently than their Linux equivalents; (2) The Azure PowerShell example for uploading certificates is provided, but there is no equivalent Azure CLI (cross-platform) example; (3) The IIS section is listed before Apache and NGINX, and the PowerShell script uses Windows-style file paths.
Recommendations:
- Add Azure CLI examples alongside or before Azure PowerShell for certificate upload and configuration, as CLI is cross-platform.
- When referencing web servers, alternate the order (e.g., list Apache or NGINX before IIS, or group them without implied priority).
- Include Linux-style file paths in examples (e.g., /home/user/contoso.cer) or note that file paths should be adapted to the user's OS.
- Explicitly state that all OpenSSL commands work identically on Linux and Windows, and provide any OS-specific caveats if needed.
- Where possible, provide screenshots or instructions for both Windows and Linux environments (e.g., adding root certificates to trusted stores).
Create pull request