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:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation demonstrates a Windows bias in several areas: all quickstart scripting examples for building and pushing custom container images use PowerShell (.ps1) scripts and PowerShell syntax, with no equivalent Bash or shell script examples for Linux/macOS users. The instructions reference 'Docker Desktop', a tool primarily associated with Windows and macOS, and do not mention Docker Engine or Linux-native Docker workflows. There are no explicit Linux/Bash script alternatives or guidance for non-Windows environments, and the PowerShell examples are presented as the default/only option.
Recommendations:
- Provide equivalent Bash/shell script examples for building and pushing images, alongside PowerShell, to support Linux/macOS users.
- Explicitly mention and provide instructions for using Docker Engine on Linux, not just Docker Desktop.
- Where scripts are referenced (e.g., quickstart-image-build.ps1), offer or link to a Bash (.sh) version, or clarify cross-platform compatibility.
- Instruct users on how to run the scripts on Linux/macOS, or provide guidance for adapting the process to those platforms.
- Avoid assuming the use of Windows-specific tools or environments; ensure parity in documentation order and detail for both Windows and Linux workflows.
Create pull request