Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell. While Azure CLI is cross-platform, PowerShell is traditionally associated with Windows, and some examples (such as file upload paths) use Windows-style paths (e.g., D:\testFiles\textfile.csv) without mentioning Linux/macOS equivalents. Additionally, PowerShell examples and references are given equal prominence to Azure CLI, and sometimes appear before CLI in the tab order, which may subtly prioritize Windows tooling. There are no explicit Linux/macOS examples (e.g., Bash, Linux file paths) for local file operations.
Recommendations
- Add explicit Linux/macOS examples for file paths and local operations (e.g., use /home/user/testFiles/textfile.csv alongside D:\testFiles\textfile.csv).
- Clarify that Azure CLI commands work on Linux/macOS and Windows, and highlight any OS-specific considerations.
- Consider adding Bash examples for common operations, especially for file uploads to Azure Storage.
- When showing PowerShell examples, note that PowerShell Core is available cross-platform, but provide guidance for Linux/macOS users where relevant.
- Ensure tab order does not always put PowerShell before CLI, or clarify that CLI is the recommended cross-platform approach.
Create Pull Request