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
⚠️
windows_tools
Summary:
The documentation demonstrates a Windows-first bias in several areas. Environment variable setup instructions are presented first for Windows (cmd and PowerShell), with Linux/macOS instructions following. The use of 'setx' and PowerShell commands are highlighted, while the Linux/macOS equivalent uses a generic 'export' command. Visual Studio Code is mentioned as cross-platform, but no Linux-specific editors or shell instructions are provided. The overall flow and examples assume a Windows-centric workflow, with Linux/macOS support added as an afterthought.
Recommendations:
- Present Linux/macOS and Windows instructions side by side or in parallel tabs, rather than listing Windows first.
- Use cross-platform shell commands (e.g., bash) as the default, with Windows alternatives provided as needed.
- Include Linux/macOS-specific tooling or editor suggestions (e.g., Vim, Emacs, GNOME Terminal) alongside Visual Studio Code.
- Avoid using Windows-specific tools (like 'setx') as the primary example; instead, provide both 'export' (for Linux/macOS) and 'setx' (for Windows) in equal prominence.
- Where possible, use neutral language and avoid implying Windows is the default or primary development environment.
Create pull request