Bias Analysis
Detected Bias Types
powershell_heavy
missing_linux_example
windows_tools
windows_first
Summary
The documentation provides detailed instructions for moving an Azure Web PubSub resource using the Azure Portal and Azure PowerShell. All command-line examples use Azure PowerShell, which is most commonly used on Windows, and there are no examples using Azure CLI, Bash, or Linux-native tools. The use of 'notepad' as the editor in the PowerShell example further reinforces a Windows-centric approach. There are no instructions or examples for Linux or cross-platform users, and PowerShell is presented as the only scripting option.
Recommendations
- Add equivalent Azure CLI (az) command examples for exporting, editing, and deploying ARM templates, as Azure CLI is cross-platform and widely used on Linux and macOS.
- Replace or supplement 'notepad' with cross-platform editors (e.g., 'nano', 'vim', or 'code') or use a generic instruction like 'open the file in your preferred text editor'.
- Explicitly mention that PowerShell Core is available cross-platform, or provide Bash script equivalents.
- Reorder or parallelize instructions so that Azure CLI and PowerShell examples are presented together, or allow users to select their preferred platform.
- Include a note or section for Linux/macOS users, ensuring parity in guidance and tool recommendations.
Create Pull Request