Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation demonstrates a moderate Windows bias. PowerShell is consistently presented as the first example in every code tab, followed by Azure CLI and then Terraform. Prerequisites and instructions reference Azure PowerShell before Azure CLI, and installation links for PowerShell are listed first. There is a strong presence of PowerShell scripts and terminology throughout, and no explicit mention of Linux-specific shell environments or usage patterns. The CLI examples use Bash-style syntax, but there is no guidance for Linux users regarding shell compatibility, nor are there troubleshooting tips for Linux-specific issues. The documentation also refers to 'Azure PowerShell installed locally' as a prerequisite, which is more common on Windows.
Recommendations
- Alternate the order of code tabs so that Azure CLI (Bash) examples appear before PowerShell, or make CLI the default/first shown example.
- Explicitly mention Linux as a supported platform in prerequisites and provide guidance for using Azure CLI in Bash on Linux/macOS.
- Add notes or troubleshooting sections for common Linux-specific issues (e.g., shell quoting, environment variables, file paths).
- Clarify that Azure CLI is cross-platform and highlight its use on Linux/macOS, possibly with screenshots or terminal prompts.
- Where PowerShell is referenced, add a note that it is available cross-platform, but CLI may be more familiar to Linux users.
- Ensure that all instructions (such as feature flag registration) include both CLI and PowerShell commands side-by-side, not PowerShell first.
- Consider including Linux-specific terminology (e.g., 'run these commands in your Bash shell') and avoid Windows-centric phrasing.
Create Pull Request