Document Details
Bastion Connect Vm Ssh Linux
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
Summary
The documentation page is generally focused on connecting to Linux VMs via Azure Bastion through the Azure portal, which is a cross-platform web interface. However, there is a recurring bias in the guidance for storing SSH keys in Azure Key Vault: the instructions and links reference PowerShell (a Windows-centric tool) first and do not provide explicit Linux/Unix shell (Bash) or cross-platform CLI examples. The linked quick-create guide for Key Vault uses PowerShell, and the recommendation to use 'PowerShell or Azure CLI' always lists PowerShell first, with no Bash-specific or Linux-native instructions. There are no explicit Linux command-line examples for common tasks, and the documentation does not mention or show parity for Linux users in these steps.
Recommendations
- Provide explicit Azure CLI (Bash) examples for creating and managing Azure Key Vault resources and secrets, and ensure these are presented alongside or before PowerShell examples.
- Update links such as 'Create a key vault' to point to both PowerShell and Azure CLI quickstart guides, or to a landing page that lets users choose their preferred platform.
- When referencing command-line tools, use 'Azure CLI' as the default or present it before PowerShell, as Azure CLI is cross-platform and more familiar to Linux users.
- Add notes or sections clarifying that all steps can be performed from Linux/macOS terminals using Azure CLI, and provide sample commands.
- Review all instructions to ensure that Linux users are not implicitly directed to use Windows-centric tools or workflows.
Create Pull Request
Clean