Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
windows_tools
powershell_heavy
Summary
The documentation exhibits several signs of Windows bias. File paths are consistently given in Windows format (e.g., C:\Templates\...), with no mention of Linux/macOS equivalents. All command-line examples use Windows-style paths, and there are no examples or notes for Linux/macOS users regarding file locations or path syntax. PowerShell is featured prominently, sometimes before Azure CLI, and references to Azure PowerShell are made without equivalent coverage for Bash or other shells. The 'Grant access' section links only to a PowerShell tutorial. There is no mention of Linux-specific tools, nor are there any screenshots or instructions tailored to non-Windows platforms.
Recommendations
- Provide Linux/macOS path examples alongside Windows paths (e.g., ~/Templates/createStorageV1.json).
- Add notes or callouts for Linux/macOS users regarding file system differences and path syntax.
- Ensure Azure CLI examples use cross-platform path syntax or clarify usage on different OSes.
- Include links to equivalent tutorials for Bash or Azure CLI where PowerShell is referenced.
- Balance the order of examples so that Azure CLI and PowerShell are presented equally, or alternate which comes first.
- Add screenshots or instructions for Linux/macOS environments where relevant.
- Explicitly state that the instructions apply to all supported platforms and highlight any platform-specific considerations.
Create Pull Request