Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
Summary
The documentation demonstrates a subtle Windows bias by referencing Windows-centric tools and workflows before or instead of Linux equivalents. For example, Visual Studio and Visual Studio Code are mentioned as editors, but Linux-friendly editors are not. The section on multi-line strings and comments refers to Azure PowerShell and Azure CLI, but does not provide explicit Linux shell examples or mention Linux-specific considerations. There are no PowerShell-heavy command examples, but the lack of Linux-specific guidance and the prioritization of Windows tools suggest a 'windows_first' and 'missing_linux_example' bias.
Recommendations
- Include references to Linux-friendly editors (e.g., Vim, Emacs, nano) alongside Visual Studio and Visual Studio Code.
- Provide explicit examples or notes for deploying templates using Linux shells (e.g., Bash) and clarify any differences in command usage or file handling.
- Mention cross-platform tools and workflows where appropriate, ensuring Linux users are equally supported.
- Add notes about file formats and encoding considerations on Linux systems, especially for JSONC and multi-line strings.
- Ensure that any references to Azure PowerShell are balanced with Azure CLI examples, and clarify CLI usage on both Windows and Linux.
Create Pull Request