Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation presents platform-specific examples for generating derived device keys in a tabbed format, with Azure CLI first (cross-platform), then Windows/PowerShell, then Linux/openssl, and finally C#. The Windows/PowerShell example is detailed and provided before the Linux/openssl example. The Azure CLI example is cross-platform and explicitly states it works on both Windows and Linux, mitigating some bias. However, the Windows/PowerShell example appears before the Linux/openssl example, and the PowerShell code is more verbose and prominent, which may create a perception of Windows preference.
Recommendations
- Ensure Linux and Windows examples are presented with equal prominence and detail.
- Consider listing Linux and Windows examples side-by-side or in alphabetical order to avoid implicit prioritization.
- Expand the Linux example to match the detail of the Windows/PowerShell example, including explanation of each step.
- Add a macOS-specific example if there are platform differences (e.g., openssl usage nuances).
- Explicitly state that all approaches are equivalent and supported, and encourage users to choose the method best suited to their environment.
Create Pull Request