About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
powershell_heavy
Summary:
The documentation generally maintains cross-platform neutrality, but in the troubleshooting section, the Windows (PowerShell) command for TCP connectivity testing (Test-TcpConnection) is listed before the Linux equivalent (nc), and the Windows command is labeled with a comment, suggesting a slight 'windows_first' and 'powershell_heavy' bias. No other examples or instructions are specifically Windows-only, and both Azure CLI and PowerShell are mentioned as options for VNet preparation. There are no missing Linux examples, but the order and labeling of commands could be improved for parity.
Recommendations:
- Present Linux and Windows command-line examples in parallel, or alternate their order in different sections to avoid always listing Windows first.
- Use neutral language such as 'On Windows' and 'On Linux' rather than '# Windows' and '# Linux' in code blocks.
- Where both Azure CLI and PowerShell are mentioned, provide explicit example commands for both platforms, or link to relevant documentation for each.
- Consider including a note at the start of the troubleshooting section that all commands are available for both Windows and Linux, and provide links to further resources for each platform.
Create pull request