Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell is referenced first and more frequently than Azure CLI, especially for tasks like retrieving tenantId and objectId, and for creating template specs. The instructions for obtaining Azure Active Directory object IDs exclusively mention PowerShell cmdlets (Get-AzSubscription, Get-AzADUser, Get-AzADServicePrincipal) without CLI or cross-platform alternatives. Visual Studio Code is mentioned as an editor, but no Linux-specific tools or workflows are highlighted. There are no explicit Linux examples or shell commands, and the overall flow assumes familiarity with Windows-centric tools.
Recommendations
- Provide Azure CLI equivalents for all PowerShell commands, especially for retrieving tenantId and objectId (e.g., az account show, az ad user show, az ad sp show).
- Present Azure CLI examples before or alongside PowerShell examples to avoid Windows-first ordering.
- Mention cross-platform editors (such as Vim, nano, or gedit) alongside Visual Studio Code.
- Clarify that all CLI commands work on Linux, macOS, and Windows, and provide shell syntax examples (bash/zsh) where appropriate.
- Add notes or sections for Linux users, including file management and environment setup tips.
- Ensure screenshots and instructions do not assume a Windows environment.
Create Pull Request