Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides onboarding instructions for Azure Lighthouse using the Azure portal, Azure CLI, and Azure PowerShell. While Azure CLI is cross-platform, PowerShell examples and references are prominent and presented alongside CLI, but there is no mention of Linux-specific patterns, shell scripting, or alternative Linux-native tools. The documentation refers to 'PowerShell' and 'Azure PowerShell' throughout, and troubleshooting steps do not include Linux-specific guidance or command-line alternatives beyond Azure CLI. The order of presentation often lists Azure PowerShell before Azure CLI, and there are no explicit Linux shell (bash/zsh) examples or references to Linux package managers or environments.
Recommendations
- Add explicit Linux shell (bash/zsh) examples for template deployment, such as using curl, wget, jq, or scripting with az CLI.
- Clarify that Azure CLI commands work identically on Linux, macOS, and Windows, and provide installation instructions for Linux environments.
- Include troubleshooting steps relevant to Linux environments, such as checking az CLI installation, permissions, and environment variables.
- When listing command-line options, present Azure CLI before PowerShell to avoid implicit Windows-first ordering.
- Reference Linux-native automation tools (e.g., cron jobs, shell scripts) for ongoing management and onboarding automation.
- Add notes or links about using Azure Cloud Shell, which is accessible from any OS and supports both bash and PowerShell.
Create Pull Request