Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides parity between Linux and Windows in most CLI and REST examples, but there is a subtle Windows bias in the PowerShell section, where Windows is used as the default example and Linux is mentioned only as an alternative. Additionally, PowerShell examples are given equal prominence to CLI, which is more cross-platform, but PowerShell is primarily a Windows tool. In the 'Before you begin' section, Linux guidance is more extensive, but Windows instructions are presented as a single block, potentially implying Windows as the default. The ordering of examples sometimes places Windows first.
Recommendations
- Alternate the order of Linux and Windows examples so neither is always first.
- Provide explicit Linux PowerShell (pwsh) compatibility notes, or clarify that CLI is recommended for Linux/macOS users.
- In PowerShell examples, use Linux as the default in at least one example, or provide parallel Linux and Windows examples.
- Add a note at the start of the PowerShell section clarifying its platform support and recommending CLI for Linux/macOS.
- Ensure that all example code blocks and parameter tables clearly indicate which OS they apply to, and provide Linux/macOS equivalents where relevant.
Create Pull Request