Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides both Azure CLI and PowerShell examples for key operations, but PowerShell (a Windows-centric tool) is given equal prominence and dedicated tabs. There is no mention of Linux-specific tools or shell patterns (e.g., Bash scripting), and PowerShell is referenced before REST in some sections. The guidance for logging in references Connect-AzAccount (PowerShell) and az login (CLI), but does not mention Linux authentication nuances or alternatives. The 'Add private endpoint' section links to PowerShell before CLI and does not mention Linux-specific workflows.
Recommendations
- Add explicit Bash shell examples alongside Azure CLI, demonstrating usage in typical Linux environments.
- Clarify that Azure CLI is cross-platform and provide sample commands in Bash syntax (with environment variable usage, piping, etc.).
- Include notes or examples for Linux authentication (e.g., using service principals, environment variables) where appropriate.
- Ensure that CLI examples are presented before PowerShell, or provide a Linux-first workflow where relevant.
- Reference Linux-native tools or scripting patterns where possible, and avoid implying PowerShell is the default for all users.
- In sections linking to further documentation, ensure Linux and CLI resources are listed before or alongside PowerShell/Windows resources.
Create Pull Request