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
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation demonstrates a mild Windows bias in the 'Install web server' section, where users are instructed to open a PowerShell prompt on Windows and a Bash prompt on Mac/Linux, but all SSH command examples use Windows-style paths (e.g., .\Downloads\myKey.pem) and do not provide Linux/macOS equivalents. There are no explicit Linux command examples for SSH, and the documentation assumes familiarity with Windows conventions. Additionally, PowerShell is mentioned before Bash, and there are no Linux-specific troubleshooting or tool references.
Recommendations:
- Provide both Windows (PowerShell) and Linux/macOS (Bash) command examples for SSH, with appropriate path formats (e.g., .\Downloads\myKey.pem for Windows, ~/Downloads/myKey.pem for Linux/macOS).
- List Bash/Linux instructions before or alongside PowerShell/Windows instructions to avoid the impression of Windows primacy.
- Include troubleshooting tips or notes relevant to Linux/macOS users, such as setting key file permissions (chmod 600 myKey.pem).
- Where file paths are referenced, clarify the differences between Windows and Linux/macOS path conventions.
- Consider adding a table or callout box that shows side-by-side commands for both platforms.
Create pull request