Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
Summary
The documentation page demonstrates subtle Windows bias, most notably by referencing Windows-centric tools and workflows (such as Visual Studio and PowerShell) before or instead of Linux alternatives. For example, schema recommendations are given for Visual Studio and Visual Studio Code, but no mention is made of Linux editors (e.g., Vim, Emacs, nano) or cross-platform JSON editors. The section on multi-line strings and comments references Azure PowerShell and CLI, but does not provide Linux-specific CLI usage or examples. There are no explicit Linux shell (bash) or deployment examples, nor are Linux-native tools or patterns discussed.
Recommendations
- Add explicit Linux shell (bash) examples for template deployment alongside PowerShell examples.
- Mention Linux-compatible editors (e.g., Vim, nano, Emacs, Sublime Text) when discussing JSON schema support and editing.
- When referencing Azure CLI, clarify usage on Linux (e.g., shell quoting, file encoding, line endings).
- Provide parity in tool recommendations, such as cross-platform editors and deployment methods.
- Include notes or examples for deploying templates from Linux environments, addressing any differences or caveats.
Create Pull Request