Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a Windows bias, especially in the 'readEnvironmentVariable' section. All examples for setting environment variables use PowerShell syntax and reference .NET/Windows APIs. There are no examples for Linux or macOS shells (e.g., Bash), and Windows methods are mentioned exclusively and first. This may confuse or exclude users working on non-Windows platforms.
Recommendations
- Add equivalent examples for setting environment variables in Bash (Linux/macOS), e.g., export testEnvironmentVariable="Hello World!".
- Mention both Windows (PowerShell/CMD) and Linux/macOS (Bash/Zsh) methods for setting environment variables, and present them together or in parallel sections.
- Reference cross-platform documentation for environment variables, not just Windows/.NET APIs.
- Clarify that Bicep and its parameter files are cross-platform and that environment variable handling depends on the user's OS/shell.
- Where possible, avoid assuming PowerShell as the default shell; provide parity for Linux/macOS users.
Create Pull Request