Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates a Windows bias by exclusively providing PowerShell-based examples using the 'armclient' tool, which is primarily used on Windows. There are no Linux shell (bash/curl) examples, nor is there mention of Linux-native tools or cross-platform alternatives. The instructions and code samples assume a Windows/PowerShell environment, making it less accessible for Linux users.
Recommendations
- Provide equivalent examples using bash and curl for REST API calls, showing how to perform the same operations on Linux or macOS.
- Mention cross-platform tools such as 'az' CLI, which works on both Windows and Linux, and provide sample commands.
- Explicitly state that the APIs can be accessed from any OS and clarify tool requirements for each platform.
- Reorder or balance examples so that Linux and Windows usage patterns are presented equally, or at least mention Linux alternatives alongside Windows instructions.
- Add a section on prerequisites for both Windows and Linux environments, including installation instructions for required tools.
Create Pull Request