Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell. While the CLI examples are cross-platform, the documentation consistently presents PowerShell examples (Windows-centric) as a primary method and includes references to Windows-specific tools (e.g., dig.exe). The CLI tab uses 'azurepowershell-interactive' as its code block language, which may confuse Linux/macOS users. The mention of 'dig.exe' (rather than just 'dig') and the ordering of PowerShell before Linux-native shell examples suggest a Windows-first approach. There are no explicit Linux/macOS shell examples (e.g., bash, zsh), nor is there guidance for Linux-specific environments.
Recommendations
- Add explicit bash/zsh examples for Linux/macOS users, especially for Azure CLI commands and DNS queries.
- Clarify that Azure CLI commands work on Linux/macOS and provide sample outputs from those platforms.
- Replace references to 'dig.exe' with 'dig', and note that 'dig' is available on Linux/macOS by default.
- Use neutral code block language tags (e.g., 'bash', 'sh', 'shell') for CLI examples instead of 'azurepowershell-interactive'.
- Consider reordering examples so that cross-platform methods (CLI, bash) appear before Windows-specific (PowerShell) examples.
Create Pull Request