Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell. PowerShell examples are given equal prominence to Azure CLI, but PowerShell is a Windows-centric tool, and several examples (e.g., file upload using Set-AzStorageBlobContent) use Windows file paths (D:\testFiles\textfile.csv) without mentioning Linux/macOS equivalents. There is no explicit mention of Linux or macOS-specific instructions, nor are there Bash or shell script examples for local environments. The CLI examples are cross-platform, but the documentation does not clarify this, and PowerShell is presented as a primary automation option, which may create friction for Linux/macOS users.
Recommendations
- Explicitly state that Azure CLI is cross-platform and can be used on Linux/macOS/Windows.
- Provide Bash or shell script equivalents for file upload and other operations, especially where PowerShell uses Windows file paths.
- Include notes or examples for Linux/macOS users, such as using ~/testFiles/textfile.csv or /home/user/testFiles/textfile.csv for file paths.
- Clarify that PowerShell Core is available on Linux/macOS, but provide guidance for users who prefer native shell environments.
- Where possible, show CLI examples before PowerShell, or at least alternate the order to avoid Windows-first perception.
Create Pull Request