Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation provides a detailed PowerShell script for certificate management, which is Windows-centric and does not mention or provide equivalent steps for Linux/macOS users. There is no guidance on using Azure CLI, OpenSSL, or other cross-platform tools for certificate creation and assignment. The PowerShell approach is presented as the only method, creating friction for non-Windows users.
Recommendations
- Add equivalent instructions using Azure CLI for certificate assignment and management.
- Provide OpenSSL-based steps for certificate creation, which work on Linux/macOS.
- Explicitly state platform requirements for the PowerShell script and offer alternatives.
- Reorder examples so that cross-platform methods (e.g., Azure CLI) are presented before or alongside PowerShell.
- Include troubleshooting steps and commands that are platform-agnostic wherever possible.
Create Pull Request