Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a strong Windows bias. All command-line examples are shown using PowerShell syntax, and there are no bash or Linux shell equivalents. Windows-specific tools and patterns (such as Connect-AzAccount, Set-AzContext, and New-AzResourceGroupDeployment) are used exclusively, and there is no mention of how to perform these tasks on Linux or macOS. The only explicit OS note is a warning that JavaScript UDFs only work on Windows, but no guidance is given for Linux users. This may make it difficult for users on non-Windows platforms to follow the documentation or understand how to adapt the instructions.
Recommendations
- Provide all CLI examples in both PowerShell and bash (Linux/macOS) syntax, or use a neutral shell syntax where possible.
- Include instructions for installing and using the Azure CLI (az) as an alternative to Azure PowerShell, especially for deployment steps.
- Explicitly mention OS compatibility for all commands and features, and provide alternatives or workarounds for Linux/macOS users.
- Add a section or callouts for Linux/macOS users, highlighting any differences or limitations.
- Avoid using Windows-specific path separators (\) in examples, or show both Windows and Linux/macOS path formats.
Create Pull Request