Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page shows evidence of Windows bias in its cross-platform guidance. References to command-line tooling for creating private endpoints mention PowerShell (New-AzPrivateEndpoint) before the Azure CLI (az network private-endpoint create), and do not provide explicit Linux shell examples or guidance. There are no examples or instructions for Linux-specific tools, nor is there parity in demonstrating how to perform tasks on Linux versus Windows. The documentation assumes familiarity with Windows-centric tools and patterns, and omits Linux-first or cross-platform instructions.
Recommendations
- Provide explicit Linux shell (bash) examples alongside PowerShell, especially when referencing Azure CLI commands.
- List Azure CLI (cross-platform) commands before PowerShell commands to avoid Windows-first ordering.
- Include notes or sections on how to perform private endpoint operations on Linux systems, including installation and usage of Azure CLI.
- Avoid referencing PowerShell exclusively; ensure all command-line instructions are cross-platform or have platform-specific variants.
- Add troubleshooting and configuration guidance relevant to Linux environments, such as DNS setup or network interface inspection using Linux tools.
Create Pull Request