Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a moderate Windows bias. Windows tools and workflows (such as Azure PowerShell and Visual Studio Code) are mentioned alongside or before cross-platform options, and there are no explicit Linux-specific examples or CLI instructions. Keyboard shortcuts are provided for Windows and macOS, but Linux is only mentioned as sharing the Windows shortcut. There is no mention of Linux-native editors or shell environments, and examples using Azure CLI are not prioritized over PowerShell.
Recommendations
- Provide explicit Linux examples and instructions, especially for command-line operations (e.g., show Azure CLI commands before PowerShell).
- Include Linux-native editor alternatives (such as Vim, Emacs, or JetBrains IDEs) or at least acknowledge their use.
- When referencing keyboard shortcuts, clarify Linux-specific variations if they exist, and avoid grouping Linux with Windows unless they are truly identical.
- Ensure that all tools and workflows mentioned (such as exporting resources or running deployments) include parity for Linux users, with clear instructions.
- Where possible, use Azure CLI as the primary example, as it is cross-platform, and mention PowerShell as an alternative.
- Add a section or callout highlighting any platform-specific limitations or differences, so Linux users are aware of potential issues.
Create Pull Request