Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
Summary
The documentation page exhibits mild Windows bias in its tooling and deployment instructions. Visual Studio Code and Visual Studio (Windows-centric editors) are mentioned first and exclusively in the schema selection guidance, with no mention of Linux editors or workflows. Deployment instructions for multi-line strings and comments reference Azure PowerShell and Azure CLI, but do not provide parity examples or explicit guidance for Linux shell usage (e.g., Bash). There are no references to Linux-native editors, tools, or command-line patterns, and no explicit Linux examples are given.
Recommendations
- Include explicit references to Linux editors (e.g., Vim, Emacs, nano) and how to configure schema validation in those environments.
- Provide Azure CLI examples using Bash syntax, and clarify any differences in usage between Windows (PowerShell/CMD) and Linux shells.
- Mention cross-platform editors (e.g., VS Code) as available on both Windows and Linux, and avoid implying Windows-only usage.
- Add notes or examples for deploying templates from Linux environments, including any required flags or considerations.
- Ensure that any references to PowerShell or Visual Studio are balanced with Linux equivalents or alternatives.
Create Pull Request