Document Details
Tutorial Hybrid Portal Policy
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
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation demonstrates a Windows bias by exclusively using Windows Server virtual machines for all examples, providing only PowerShell commands for VM configuration (IIS installation), and omitting any Linux-based VM or CLI (Bash/Azure CLI) examples. The workflow for deploying and configuring resources is tailored to Windows administrators, with no mention of Linux alternatives or parity in tooling.
Recommendations
- Provide parallel examples for deploying and configuring Linux-based virtual machines (e.g., Ubuntu) in both the spoke and on-premises roles.
- Include Azure CLI (Bash) commands alongside PowerShell for resource creation and configuration, especially for tasks like installing web servers (e.g., using apt and nginx or apache2).
- Demonstrate how to test connectivity using Linux tools (e.g., curl, ssh) in addition to Windows tools (RDP, browser).
- When referencing VM extensions or scripts, show both PowerShell and Bash/CLI equivalents for installing and configuring software.
- Explicitly mention that the tutorial is applicable to both Windows and Linux environments, and provide guidance for users who prefer or require Linux-based solutions.
Create Pull Request
Clean