Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by providing extensive Azure PowerShell examples and cmdlets, which are primarily used on Windows. PowerShell is presented alongside Azure CLI, but there are no explicit Linux shell (bash) examples, nor is there mention of Linux-specific tools or workflows. The documentation references Windows-centric tools and patterns (PowerShell, cmdlets) and does not clarify cross-platform compatibility or provide parity for Linux users. Additionally, the ordering of examples sometimes places PowerShell before CLI, and there is no mention of Linux installation or usage nuances.
Recommendations
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and provide bash/zsh shell examples where appropriate.
- Add notes or sections on installing and using Azure CLI and PowerShell on Linux, including any platform-specific caveats.
- Include Linux-native command examples (e.g., bash scripts, use of environment variables, piping, etc.) for common workflows.
- Clarify that PowerShell Core is cross-platform, but also provide bash alternatives for users who do not use PowerShell.
- Ensure ordering of examples does not prioritize Windows tools (PowerShell) over cross-platform tools (CLI), or alternate the order.
- Mention and link to Linux documentation or guides for managing IoT Central applications.
Create Pull Request