Bias Analysis
Detected Bias Types
windows_tools
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page exhibits a Windows bias in several ways: it references Windows-specific certificate stores and tools (such as certmgr.exe and PowerShell), provides certificate management instructions only for Windows environments, and omits equivalent Linux procedures or examples. The use of PowerShell and Windows Certificate Manager is described in detail, while no mention is made of Linux commands (e.g., openssl, keytool) or Linux certificate store locations. Additionally, App Service Environment instructions are repeatedly described as 'Windows-only' without Linux alternatives or parity guidance.
Recommendations
- Add instructions for managing certificates on Linux hosts, including how to add certificates to the appropriate Linux certificate stores (e.g., /etc/ssl/certs, update-ca-certificates).
- Provide Linux command-line examples for viewing and adding certificates, such as using openssl, keytool, or update-ca-certificates.
- Clarify whether the MQ connector and Logic Apps workflows can run on Linux-based App Service plans, and if so, provide equivalent steps for those environments.
- Include troubleshooting guidance for Linux environments, such as how to check cipher suites and certificate validation using Linux tools.
- When referencing certificate management, mention both Windows and Linux approaches, or explicitly state platform limitations.
- Avoid presenting Windows tools and procedures as the default or only option; structure instructions to address both platforms equally or in parallel.
Create Pull Request