Detected Bias Types
Windows First
Powershell Heavy
🔧
Windows Tools
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell is presented as the first option for deployment, and instructions reference running code in PowerShell locally, Visual Studio Code, or Azure Cloud Shell before mentioning CLI. The CLI instructions also mention running in PowerShell, which is a Windows-centric shell, and the example path separator in the CLI deployment command uses Windows-style backslashes ('src\templates\fhirtemplate.json'), which may confuse Linux/macOS users. Additionally, the Bash prerequisite suggests 'Git Bash' (a Windows tool) before mentioning Bash shells more generally.
Recommendations
- Present CLI and PowerShell instructions in parallel, or list CLI first to avoid Windows-first bias.
- In CLI instructions, use POSIX-style forward slashes for file paths (e.g., 'src/templates/fhirtemplate.json') and note that Windows users may need to adjust paths.
- Clarify that Bash is available natively on Linux/macOS and that Git Bash is only needed for Windows users.
- Remove references to running CLI commands in PowerShell for non-Windows platforms; instead, mention native terminals for Linux/macOS.
- Explicitly state that all steps are cross-platform and provide any platform-specific caveats.