Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation exhibits a notable Windows bias. All command-line examples for interacting with the Central Secret Service REST API use PowerShell and Windows-specific tooling (Invoke-WebRequest, CertificateThumbprint), with no equivalent Linux/macOS examples (e.g., curl, openssl). Windows paths (C:\secrets) are shown first and in mainline examples, while Linux paths (/mnt/secrets) are relegated to comments. There is no guidance for Linux authentication or certificate handling, and no mention of Linux/macOS shell usage for API calls.
Recommendations
- Provide REST API usage examples using curl for Linux/macOS, including authentication with client certificates.
- Document how to obtain and use certificate thumbprints or equivalents on Linux/macOS.
- Show Linux file paths and container mount points in main examples, not just as commented alternatives.
- Clarify any OS-specific requirements or differences in Service Fabric cluster setup and secret management.
- Ensure all critical workflows (create, set, examine secrets) have both Windows and Linux/macOS instructions.
Create Pull Request