Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a moderate Windows bias. PowerShell examples and references to Windows-specific tools (such as Visual Studio and .csproj modifications) are provided alongside Azure CLI and portal instructions, but Linux-specific instructions are less prominent or are only present in dedicated Linux pivots. In several places, PowerShell is given equal or greater prominence than Azure CLI, and some advanced configuration (like pinning via .csproj) is only described for Windows/.NET scenarios. Additionally, some instructions (such as setting linuxFxVersion) are less detailed or lack parity with Windows guidance.
Recommendations
- Ensure that Linux-specific instructions are as detailed and discoverable as Windows instructions, not just in pivots but in mainline content where possible.
- Provide parity for advanced scenarios, such as pinning runtime versions, for both Windows and Linux, including equivalent examples for non-.NET stacks.
- Avoid referencing Windows-specific tools (e.g., Visual Studio, .csproj) without offering Linux/OSS alternatives or clarifying their scope.
- Where PowerShell is presented, ensure Bash or shell script equivalents are provided for Linux users.
- Consider leading with cross-platform tools (Azure CLI, portal) before platform-specific tools (PowerShell, Visual Studio) to reduce perceived Windows-first bias.
Create Pull Request