Bias Analysis
Detected Bias Types
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation provides a detailed PowerShell example for interacting with the API, relying on the MSAL.PS module and Windows certificate store. There are no equivalent examples for Linux/macOS environments, nor are cross-platform tools (such as curl, Python, or OpenSSL) mentioned. This creates friction for non-Windows users, who must adapt the instructions without guidance.
Recommendations
- Add sample requests using cross-platform tools such as curl or Python (requests, msal).
- Document how to acquire and use certificates on Linux/macOS (e.g., using OpenSSL, storing as PEM files).
- Provide guidance for authenticating and sending requests from Linux/macOS, including environment-specific notes.
- List PowerShell as one option, but present cross-platform alternatives first or alongside.
- Clarify that the API is platform-agnostic and can be accessed from any OS with HTTP tooling.
Create Pull Request