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 page demonstrates a Windows bias by providing all shell/command-line examples in PowerShell syntax (e.g., using 'cd' and 'git clone' in PowerShell code blocks), and does not show Linux/macOS-specific shell commands or mention platform differences. The instructions and code blocks assume a Windows environment, with no explicit guidance for Linux or macOS users. There is also a lack of explicit mention or examples for Linux tools or terminal usage, and no alternative instructions for non-Windows environments.
Recommendations:
- Provide parallel shell command examples for Linux/macOS (e.g., use bash/zsh syntax and code blocks alongside PowerShell).
- Use generic 'shell' or 'bash' code blocks for cross-platform commands, unless a command is truly Windows-specific.
- Explicitly mention that the commands work on all platforms, or note any platform-specific differences.
- Include installation and usage notes for Linux and macOS for prerequisites like Azure CLI, Git, and Visual Studio Code.
- Add a section or callout for Linux/macOS users, clarifying any differences in environment variable setup, file paths, or authentication steps.
- Avoid using PowerShell-specific code blocks unless necessary; prefer 'bash' or 'shell' for cross-platform compatibility.
Create pull request