Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides upgrade instructions for Azure Blob Storage to Data Lake Storage using three main methods: Portal, PowerShell, and Azure CLI. The PowerShell section is explicitly Windows-focused, instructing users to 'Open a Windows PowerShell command window' and referencing Windows PowerShell as the default shell for CLI usage. PowerShell examples are given before Azure CLI examples, and there is an implicit assumption that users are on Windows when using PowerShell. The CLI section mentions using Windows PowerShell as a console application, even though Azure CLI is cross-platform. There are no Linux/macOS-specific instructions or clarifications for running PowerShell Core or Azure CLI on those platforms.
Recommendations
- Clarify that Azure PowerShell can be used on Linux/macOS via PowerShell Core, and provide instructions for installing/running PowerShell on those platforms.
- In CLI sections, avoid referring to 'Windows PowerShell' as the default console application; mention alternatives like Bash, Terminal, or PowerShell Core for Linux/macOS users.
- Provide explicit examples or notes for Linux/macOS users, such as how to run Azure CLI commands in Bash or Terminal.
- Ensure that cross-platform parity is maintained by listing CLI instructions before or alongside PowerShell, or by indicating that both methods are equally supported on all platforms.
Create Pull Request