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 generally aims for cross-platform parity, but there are subtle Windows biases. Command-line examples are consistently provided for both Bash (Linux/macOS) and Cmd (Windows), but the Windows/Cmd tabs are always listed after Bash, which is positive. However, there is a notable absence of explicit PowerShell examples, which is good, but the documentation refers to 'command prompt' (a Windows term) alongside 'terminal' in some places. Some sections, such as Java version support, list Windows before Linux, and the table for supported Java versions is headed 'Java versions (Windows)' before 'Java versions (Linux)'. There are no Linux-specific tools or troubleshooting steps, and the documentation does not mention Linux-specific differences or caveats. While the documentation is not overtly Windows-centric, it does not provide Linux-first or Linux-specific guidance, and some language and ordering choices subtly prioritize Windows.
Recommendations:
- When referencing command-line development, use 'terminal' or 'shell' instead of 'command prompt' to avoid Windows-centric language.
- In tables and lists, alternate the order of Windows and Linux, or use alphabetical order to avoid always listing Windows first.
- Add Linux-specific troubleshooting tips or notes where relevant, especially for environment variables, file paths, or permissions.
- Explicitly mention that all CLI and Maven commands work identically on Linux, macOS, and Windows, and highlight any OS-specific caveats.
- Consider including PowerShell examples only if there are unique steps, and always provide Bash equivalents.
- Where IDEs are mentioned, clarify that all are cross-platform (e.g., IntelliJ, Eclipse, VS Code) and that the experience is consistent across OSes.
Create pull request