Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation demonstrates a mild Windows bias by presenting PowerShell examples alongside Azure CLI, mentioning PowerShell first in Cloud Shell, and omitting explicit Linux/macOS instructions for file operations (e.g., uploading and saving files). While Azure CLI is cross-platform and Bash is mentioned, the tutorial assumes familiarity with Windows-centric tools and workflows, such as Visual Studio Code and PowerShell, and does not provide Linux-specific alternatives for steps like file saving or uploading.
Recommendations
- Explicitly mention that Visual Studio Code is available on Linux/macOS, or suggest alternatives like Vim, nano, or other editors.
- Provide Linux/macOS-specific instructions for saving and uploading files (e.g., using terminal commands or native file dialogs).
- Present CLI/Bash examples before PowerShell, or side-by-side, to avoid Windows-first ordering.
- Clarify that Azure CLI commands work identically on Linux/macOS and Windows.
- Include screenshots or instructions showing the process on Linux/macOS where relevant.
Create Pull Request