Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a moderate Windows bias. PowerShell examples are consistently presented before Azure CLI examples, and the documentation uses Windows-specific terminology and tools (e.g., PowerShell, %USERPROFILE% path) as defaults or primary references. Linux and Mac paths are included, but with less detail. There are no Bash or shell script examples, and the documentation assumes familiarity with Windows conventions.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI (cross-platform) first to avoid implicit prioritization of Windows.
- Include Bash or shell script equivalents where relevant, especially for common automation tasks.
- Provide more detailed Linux and Mac path examples, matching the specificity given to Windows (e.g., show full Linux/Mac paths, not just the root folder).
- Clarify that Azure CLI commands work identically on Windows, Linux, and Mac, and encourage its use for cross-platform compatibility.
- Where possible, avoid Windows-specific environment variables (like %USERPROFILE%) in favor of cross-platform alternatives (like $HOME or ~).
Create Pull Request