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 is heavily biased toward Windows environments. All examples use Windows-specific images, tools (PowerShell, WinGet), and scripting patterns. There are no examples or mentions of Linux-based images, shell scripts, or Linux-native package managers. The built-in tasks and customization mechanisms are described exclusively in terms of Windows tools and workflows.
Recommendations:
- Add examples using Linux-based images (e.g., Ubuntu, Debian) in the 'image' field.
- Include built-in tasks or guidance for running shell scripts (bash/sh) alongside PowerShell.
- Provide Linux equivalents for package installation, such as apt, yum, or snap, in addition to WinGet.
- Show sample task.yaml and devbox.yaml files that use Linux shell commands and Linux file paths.
- Clarify in the documentation whether Linux environments are supported, and if not, explicitly state this limitation.
- If Linux is supported, ensure parity in documentation coverage for both Windows and Linux customization scenarios.
Create pull request
Flagged Code Snippets
$schema: 1.0
name: project-sample-1
image: MicrosoftWindowsDesktop_windows-ent-cpc_win11-21h2-ent-cpc-m365
tasks:
- name: "powershell"
inputs:
command:
image: MicrosoftWindowsDesktop_windows-ent-cpc_win11-21h2-ent-cpc-m365
tasks:
- name: winget
parameters:
package: GitHub.GitHubDesktop
tasks:
- name: powershell
timeout: 1800 # in seconds
parameters:
command: <command>
name: powershell
description: Execute a powershell command
author: Microsoft Corporation
command: ".\runcommand.ps1 -command {{command}} -workingDirectory {{workingDirectory}}"
inputs:
command:
type: string
defaultValue: ""
required: true
description: The command to execute
workingDirectory:
type: string
defaultValue: ""
required: false
description: The working directory to execute the command in
description: This task executes a powershell command
command: ".\runcommand.ps1
command: ".\runcommand.ps1 -command {{command}} -workingDirectory {{workingDirectory}}"