Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides deployment instructions for Azure dashboards using three methods: Azure portal, Azure CLI, and Azure PowerShell. While Azure CLI is cross-platform and shown before PowerShell, the PowerShell section is included and described in detail, which may be seen as Windows-centric. Additionally, PowerShell examples are given after CLI, but no explicit Linux/macOS shell examples (such as Bash or shell scripting) are provided. The documentation mentions Azure PowerShell alongside Azure CLI and REST API in the overview, but does not provide Linux-specific guidance or examples. The order of examples (CLI before PowerShell) reduces bias, but the presence of PowerShell-specific instructions without Linux/macOS shell equivalents is a minor bias.
Recommendations
- Clarify that Azure CLI commands work equally well on Windows, Linux, and macOS.
- Add explicit Bash or shell scripting examples for deploying dashboards, or note that Azure CLI commands can be run in Bash or other shells on Linux/macOS.
- Consider mentioning cross-platform compatibility of Azure PowerShell (it runs on Linux/macOS via .NET Core), or link to installation instructions for non-Windows platforms.
- Ensure that all instructions are clear for users on Linux/macOS, not just Windows.