Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by presenting Azure CLI and Azure PowerShell examples, with PowerShell (a Windows-centric tool) given its own section. There are no explicit Linux/macOS shell examples (e.g., Bash), and the use of Visual Studio Code (a cross-platform tool but often associated with Windows) is emphasized. The documentation does not mention or show Linux-specific shell commands or workflows, nor does it address platform-specific differences or considerations. The ordering of examples (CLI, then PowerShell, then Portal) also puts Windows tools before Linux-native equivalents.
Recommendations
- Add explicit Bash/Linux shell examples for exporting and decompiling templates, e.g., using Bash redirection and file paths.
- Clarify that Azure CLI commands work on all platforms and provide sample commands using Bash syntax (e.g., with single quotes, Linux file paths).
- Mention and show how to use the Bicep CLI directly in Linux/macOS terminal environments.
- Balance the order of examples so that Linux/Bash and Windows/PowerShell are presented equally or alternate their order.
- Explicitly state cross-platform compatibility and call out any platform-specific differences or requirements.
- Consider adding a table or section summarizing commands for Windows (PowerShell), Linux (Bash), and macOS.
Create Pull Request