Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a Windows bias by providing both Azure CLI and PowerShell examples for schema configuration, but omits Linux-specific shell examples (e.g., Bash scripting, environment variable usage). The PowerShell examples are given equal prominence to CLI, and Visual Studio tooling (Windows-centric) is described in detail before VS Code. There is no mention of Linux-native tools, nor are there instructions for Linux users (e.g., package installation, shell differences).
Recommendations
- Add explicit Bash/Linux shell examples for Azure CLI commands, including environment variable usage and command syntax differences.
- Include instructions for installing and using Azure CLI and related tools on Linux systems.
- Provide parity for development tooling by mentioning Linux-compatible editors (e.g., JetBrains Rider, Vim) and their workflows.
- Clarify that PowerShell examples are for Windows, and suggest alternatives for Linux users (e.g., Bash, zsh).
- Add notes or sections for Linux users regarding package management (e.g., NuGet via dotnet CLI on Linux), file system paths, and editor usage.
- Ensure that examples and instructions do not assume Visual Studio or PowerShell availability, and offer cross-platform alternatives.
Create Pull Request