Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by providing extensive PowerShell-based instructions and examples, referencing Windows-specific tools and filesystem paths (e.g., C:\bin\PSRepo), and using Windows command-line conventions. There are no equivalent Linux/bash CLI examples for scripting or automation, and the PowerShell tab is the only non-portal automation method described. The only Linux-relevant content is the use of 'dig', but even this is shown in a Windows command prompt context (C:\>dig ...), and there are no bash/Azure CLI instructions for Linux users.
Recommendations
- Add equivalent Azure CLI/bash examples for all PowerShell automation steps, including resource creation, policy management, and diagnostics.
- Provide Linux-specific instructions for setting up local repositories and installing required modules/packages.
- Include Linux shell examples for DNS queries and troubleshooting, using native Linux tools and conventions.
- Ensure that command-line examples are shown in both Windows and Linux contexts, with appropriate prompts and paths.
- Reference cross-platform tools (e.g., Azure CLI, REST API) before or alongside Windows-specific tools like PowerShell.
- Explicitly mention Linux support and parity in prerequisites and throughout the documentation.
Create Pull Request