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 generally provides both Bash and Windows CMD examples for command-line operations, but consistently lists Windows tools and environments (such as Visual Studio Code, CMD, and Windows-specific Java version support) before Linux equivalents. The Java version support table lists Windows before Linux, and the documentation references Windows-specific settings and tools prominently. There is a lack of explicit Linux shell or environment-specific troubleshooting, and the documentation sometimes assumes familiarity with Windows conventions (such as JAVA_HOME setup and CMD syntax). However, Linux is not entirely omitted, and Bash examples are present, but Windows is given priority in ordering and presentation.
Recommendations:
- Alternate the order of Bash and CMD examples, or present Bash (Linux/macOS) first to reflect the prevalence of Java development on non-Windows platforms.
- Explicitly mention Linux and macOS support and troubleshooting steps where environment variables, file paths, or shell commands are discussed.
- Include Linux-specific notes or caveats for environment setup (e.g., JAVA_HOME configuration, permissions, file system differences).
- Where developer environments are listed, do not list Visual Studio Code (a Microsoft product) first by default; consider alphabetical or usage-based ordering.
- When presenting tables (e.g., Java version support), consider listing Linux before Windows or side-by-side, and avoid implying Windows is the primary or default platform.
- Ensure all CLI examples are provided for both Bash and CMD, and consider including PowerShell only if there is a unique difference.
- Add explicit Linux/macOS troubleshooting and setup sections, especially for common issues like permissions, path separators, and shell differences.
Create pull request