Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows bias by consistently presenting PowerShell instructions and references before CLI/Bash alternatives. It suggests using PowerShell locally and mentions Windows-specific tools (e.g., Git Bash for Windows) as the default Bash shell. There is a lack of explicit Linux-native examples, and the CLI instructions reuse Windows-style file paths (e.g., 'src\templates\fhirtemplate.json'), which are not standard on Linux. The overall structure and language assume a Windows environment as the primary context.
Recommendations
- Present CLI/Bash instructions before or alongside PowerShell to avoid Windows-first ordering.
- Include explicit Linux-native examples, such as running Azure CLI in a standard Linux terminal and using Linux file paths (e.g., 'src/templates/fhirtemplate.json').
- Mention Linux and macOS compatibility for Azure CLI and provide installation links for those platforms.
- Avoid recommending Windows-specific Bash shells (like Git Bash for Windows) as the default; instead, reference native Bash on Linux/macOS.
- Clarify that both PowerShell and CLI can be used on Windows, Linux, and macOS, and provide guidance for each OS where relevant.
- Review all code samples for OS-specific syntax (e.g., path separators, environment variable usage) and provide alternatives or notes for cross-platform usage.
Create Pull Request