Bias Analysis
Detected Bias Types
windows_first
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows bias by consistently using Windows-style paths (e.g., c:\jsontemplates) in all file path examples, mentioning Windows paths before Linux equivalents, and referencing Windows tools (Azure PowerShell, Visual Studio Code) before or instead of Linux alternatives. There are no explicit Linux shell examples (e.g., bash), and Linux-style paths are only mentioned in a few places, often after the Windows version. Installation and usage guidance references Windows-centric tools and patterns, and Linux users may find it less approachable.
Recommendations
- Provide Linux/macOS path examples (e.g., /home/user/jsontemplates) alongside or before Windows paths in all relevant code blocks.
- Include bash/zsh shell command examples where appropriate, not just Azure CLI and PowerShell.
- When referencing installation instructions, ensure parity between Windows and Linux, and link to both Azure CLI and native package manager (apt, yum, brew) installation guides.
- When describing file system locations (e.g., cache paths), list Linux/macOS paths before or alongside Windows paths, not after.
- Avoid using only Windows-specific shortcuts (e.g., SHIFT+ALT+F in VS Code) and mention the Linux/macOS equivalents.
- Add explicit notes or tabs for Linux/macOS users where behavior or commands differ.
Create Pull Request