Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a Windows bias in several ways. The Azure portal (a GUI tool most commonly used on Windows) is presented first and in greatest detail for all workflows. PowerShell examples are provided in a dedicated tab, but there are no equivalent Bash or Linux shell script examples. The documentation does not mention Linux-specific tools or patterns, nor does it address platform differences in authentication or environment setup. While Azure CLI and REST API examples are included, there is no discussion of running these commands on Linux systems, nor any troubleshooting or environment notes for non-Windows users. The documentation implicitly assumes a Windows-centric workflow and audience.
Recommendations
- Add explicit Bash/Linux shell script examples for all CLI and REST API workflows, including environment setup and authentication steps.
- Include notes or troubleshooting tips for running Azure CLI and REST API commands on Linux and macOS, such as handling authentication, environment variables, and file paths.
- Provide parity in example detail: ensure that CLI and REST API sections are as comprehensive as the Azure portal and PowerShell sections.
- Mention cross-platform compatibility for all tools (Azure CLI, REST API, PowerShell), and clarify any platform-specific limitations or requirements.
- Add links to Linux/macOS installation guides for Azure CLI and PowerShell, and reference official documentation for cross-platform usage.
- Consider reordering sections so that cross-platform tools (CLI, REST API) are presented before or alongside Windows-centric tools (portal, PowerShell) to avoid implicit prioritization.
Create Pull Request