Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deployment and resource management, but PowerShell is featured equally and sometimes before Linux-native alternatives. There is no explicit mention of Linux shell (bash) or scripting environments, nor are Linux-specific instructions or screenshots provided. The examples and instructions assume familiarity with PowerShell, which is primarily a Windows tool, and do not offer parity for Linux users who may prefer bash or other shells.
Recommendations
- Add explicit bash shell examples alongside Azure CLI and PowerShell, showing how to run the CLI commands in a Linux terminal.
- Clarify that Azure CLI commands can be run natively on Linux/macOS and provide instructions for installing Azure CLI on those platforms.
- Include screenshots or instructions for accessing HDInsight and Jupyter from Linux environments, not just via the Azure Portal.
- Mention cross-platform considerations, such as differences in file paths, environment setup, or authentication between Windows and Linux.
- Avoid presenting PowerShell as the default or primary method; instead, lead with Azure CLI (which is cross-platform) and supplement with PowerShell for Windows users.
Create Pull Request