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 displays some Windows bias, particularly in the Java section, where command examples are provided for Bash, PowerShell, and Cmd, with PowerShell and Cmd (Windows shells) given equal prominence to Bash. The use of 'command prompt' and 'PowerShell' is frequent, and Windows-specific tools and patterns (such as .cmd and PowerShell tabs) are included. However, the main workflow is generally cross-platform, and Linux tools like jq are mentioned in prerequisites. Still, Windows shells and terminology are often foregrounded or given equal weight, rather than Linux-first or Linux-equal treatment.
Recommendations:
- In command examples, list Bash (Linux/macOS) first, followed by PowerShell and Cmd, to reflect the prevalence of Linux in cloud development.
- Where possible, use neutral terms like 'terminal' instead of 'command prompt' or 'PowerShell', unless the example is truly Windows-specific.
- For Java, consider providing a single cross-platform Maven command (with notes for quoting differences if needed), or clearly indicate which shell is most common for cloud developers.
- Ensure that all shell-specific instructions are balanced and that Linux/macOS users are not required to adapt Windows-centric instructions.
- Highlight Linux/macOS compatibility in prerequisites and throughout the workflow, especially for tools like Azure CLI and Azure Functions Core Tools.
- Where Windows-specific tools or patterns are mentioned (e.g., .cmd, PowerShell), provide Linux/macOS equivalents or clarify when they are not needed.
Create pull request