Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits mild Windows bias. Windows tools and patterns (such as Azure PowerShell and Visual Studio Code keyboard shortcuts) are mentioned before or alongside their Linux equivalents, but Linux-specific examples and tools are not highlighted. Azure PowerShell is referenced as a primary method for exporting resources, with no explicit mention of Bash or Linux shell scripting. Keyboard shortcuts are described with Windows notation first, and Linux is only mentioned as sharing the same shortcut, with macOS listed separately. There are no explicit Linux CLI or shell examples, and no mention of Linux-specific workflows or considerations.
Recommendations
- Provide explicit Linux/Bash shell examples for exporting resources and running Bicep commands, alongside PowerShell examples.
- List Azure CLI usage before or alongside Azure PowerShell, and clarify that both work cross-platform.
- Include Linux-specific notes or considerations where workflows may differ (e.g., file paths, environment setup).
- When describing keyboard shortcuts, avoid Windows-first notation; instead, present shortcuts for all platforms equally.
- Reference Linux-native editors (such as Vim or VS Code on Linux) and their integration with Bicep, if applicable.
- Ensure that all tools and commands mentioned are available and documented for Linux users, and provide links to relevant Linux documentation.
Create Pull Request