Bias Analysis
Detected Bias Types
powershell_heavy
missing_linux_example
windows_tools
windows_first
Summary
The documentation provides detailed instructions for relocating an Azure NSG using the Azure Portal and PowerShell, but omits equivalent guidance for Linux users. All command-line examples use PowerShell cmdlets, which are native to Windows and require extra setup on Linux. There are no Bash, Azure CLI, or cross-platform scripting examples, and file editing is demonstrated using Notepad, a Windows tool. The structure presents PowerShell as the only command-line option, implicitly prioritizing Windows workflows.
Recommendations
- Add Azure CLI examples for all steps (export, edit, deploy, verify, delete NSGs and resource groups), as Azure CLI is cross-platform and widely used on Linux.
- Include Bash shell commands for file manipulation and editing, or reference editors available on Linux (e.g., nano, vim) instead of Notepad.
- Explicitly mention that PowerShell is available on Linux, but provide installation instructions or alternatives for users who prefer Bash/Azure CLI.
- Present command-line options in a more platform-neutral way, e.g., by using tabs for 'Azure CLI', 'PowerShell', and 'Portal', and avoid implying PowerShell is the default or only choice.
- Review and update prerequisites and tool references to ensure Linux users are not excluded or required to use Windows-native tools.
Create Pull Request