Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates Windows bias primarily in the following ways: (1) The cross-platform selector lists PowerShell before Azure CLI, and the main page links to PowerShell guides twice (including classic), while only one Azure CLI link is provided. (2) The only command-line example given for certificate generation uses Windows-style 'openssl.exe' syntax, which is not standard on Linux/macOS, and does not provide a Linux/macOS equivalent. (3) There are no explicit Linux/macOS examples or references, and the documentation does not mention platform-specific considerations for non-Windows users.
Recommendations
- Provide Linux/macOS command-line examples alongside Windows examples, especially for OpenSSL usage (e.g., use 'openssl' instead of 'openssl.exe').
- In cross-platform selectors, list Azure CLI and PowerShell equally, or alternate their order to avoid implicit prioritization.
- Explicitly mention platform differences or considerations where relevant (e.g., file paths, command syntax).
- Add notes or links for Linux/macOS users to ensure parity in instructions and troubleshooting.
Create Pull Request