Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page exhibits a moderate Windows bias. PowerShell is featured prominently in prerequisites and examples, with installation instructions and code samples. Windows tools (PowerShell, Visual Studio Code) are mentioned before Linux equivalents, and Bash is only suggested as an optional install for Windows users. There are no explicit Linux/macOS-specific instructions or examples, and the CLI section assumes Bash but does not address native Linux environments directly.
Recommendations
- Add explicit instructions for Linux/macOS users in the prerequisites, including native Bash shell usage and Azure CLI installation for those platforms.
- Provide Linux/macOS-specific code samples, especially for environment setup and token retrieval, clarifying differences in shell syntax and environment variables.
- Reorder examples so that CLI/Bash instructions are presented before or alongside PowerShell, to avoid Windows-first impression.
- Mention platform-specific considerations (e.g., cURL installation on Linux/macOS, default shell differences) to ensure parity.
- Clarify that PowerShell is available cross-platform, but highlight native Bash alternatives for Linux/macOS users.
Create Pull Request