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 key areas: all quickstart scripting examples for building and pushing custom container images use PowerShell scripts (.ps1) and PowerShell syntax, with no equivalent Bash or shell script examples for Linux/macOS users. The instructions explicitly mention the need for 'Docker Desktop', a tool primarily associated with Windows and macOS, rather than platform-agnostic Docker Engine. There are no Linux-specific instructions or examples for building and pushing images, nor are cross-platform alternatives provided alongside the PowerShell examples. This may hinder Linux users or those working in non-Windows environments.
Recommendations:
- Provide equivalent Bash/shell script examples for all PowerShell (.ps1) script usage, especially for building and pushing images.
- Explicitly mention support for Linux/macOS and clarify that Docker Engine (not just Docker Desktop) is supported.
- Wherever a PowerShell command is shown, include a tabbed or side-by-side Bash alternative.
- Avoid assuming the use of Windows-specific tools (like Docker Desktop) as the default; mention platform-agnostic options first.
- Add a 'Prerequisites' note clarifying cross-platform compatibility and listing required tools for both Windows and Linux/macOS.
- Audit referenced scripts/repos to ensure they provide both .ps1 and .sh (or platform-neutral) automation options.
Create pull request
Flagged Code Snippets
.\quickstart-image-build.ps1 -Registry '{YOUR_REGISTRY}' -Directory '{DIRECTORY_TO_YOUR_IMAGE}'
.\quickstart-image.build.ps1 -Registry '{YOUR_REGISTRY}' -Directory '{DIRECTORY_TO_YOUR_IMAGE}' -Repository '{YOUR_REPOSITORY}' -Tag '{YOUR_TAG}'
.\quickstart-image-build.ps1 -Registry '{YOUR_REGISTRY}' -Directory '{DIRECTORY_TO_YOUR_IMAGE}'
.\quickstart-image.build.ps1 -Registry '{YOUR_REGISTRY}' -Directory '{DIRECTORY_TO_YOUR_IMAGE}' -Repository '{YOUR_REPOSITORY}' -Tag '{YOUR_TAG}'
FROM mcr.microsoft.com/deployment-environments/runners/core:latest