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
Bias Types:
⚠️
windows_first
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation demonstrates a Windows bias by presenting SCP and SSH commands in Windows (cmd) syntax first, and in some cases exclusively, while Linux/Unix equivalents are either not shown or are only implied. There is also mention of Windows-specific tools (e.g., Windows Subsystem for Linux, Bash on Windows 10, and Chrome with Foxy Proxy) before or instead of native Linux approaches. The documentation does not provide clear, parallel Linux command-line examples or instructions, which may hinder Linux users.
Recommendations:
- For every command-line example, provide both Windows (cmd/PowerShell) and Linux/macOS (bash) syntax side by side.
- When referencing tools like SCP or SSH, clarify the command structure for both Windows and Linux environments, including any differences in syntax or prerequisites.
- Avoid mentioning Windows-specific tools (e.g., Windows Subsystem for Linux, Bash on Windows 10) as the primary or only method; instead, present native Linux workflows first or equally.
- Include explicit instructions for Linux users, such as how to install necessary tools (e.g., OpenSSH client, SCP) and how to use them in a Linux shell.
- Where GUI steps are described (e.g., using the Azure portal), clarify if there are differences for Linux users or provide CLI alternatives where possible.
- Review all code blocks and ensure that bash commands are not labeled as cmd, and vice versa, to avoid confusion.
Create pull request