Bias Analysis
Detected Bias Types
windows_tools
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation demonstrates a notable Windows bias, especially in certificate management and troubleshooting sections. It references Windows-specific tools (certmgr.exe), Windows certificate stores, and provides only PowerShell/Kudu console examples for viewing certificates. There are no Linux/macOS equivalents or instructions for managing certificates or troubleshooting on non-Windows hosts, despite IBM MQ and Azure Logic Apps being cross-platform. Windows terminology and procedures are presented as the default or only option.
Recommendations
- Provide Linux/macOS equivalents for certificate management, such as using openssl, keytool, or Linux certificate stores.
- Add examples for viewing and adding certificates on Linux/macOS hosts (e.g., using bash, openssl, or platform-native tools).
- Clarify platform requirements for App Service Environment and certificate handling, and explicitly state if Linux/macOS are supported or not.
- Where PowerShell is used, offer alternative commands for bash/zsh or other common shells.
- Reference cross-platform documentation for certificate stores and management, not just Windows-specific links.
Create Pull Request