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
⚠️
windows_tools
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation generally presents Windows tools and patterns before Linux equivalents, such as listing 'cmd.exe' before '/bin/sh' and using Windows-style path examples and syntax. There is a tendency to describe Windows-specific details first, and some examples (e.g., directory postfixes) use Windows path separators without showing Linux equivalents. There are also references to Windows-specific environment variable naming conventions and tools, with less emphasis or detail for Linux.
Recommendations:
- Present Linux and Windows examples side-by-side, or alternate which platform is shown first to avoid implicit prioritization.
- For directory and path examples, always show both Windows (backslash) and Linux (slash) formats.
- Where environment variable naming conventions differ (e.g., underscores vs. hash), clearly document both and provide explicit Linux examples.
- Expand Linux-specific guidance, such as showing how to use shells other than /bin/sh (e.g., bash), and clarify any differences in behavior.
- Avoid using only Windows tools (e.g., 'cmd.exe') in explanations; always provide the Linux equivalent with equal prominence.
- Include Linux-specific notes where features are not available or behave differently, and ensure parity in example depth and clarity.
Create pull request