Document Details
Reference Dev Box Customizations
This page contains Windows bias
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
Detected 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
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2025-07-12 23:44 | #41 | cancelled |
Biased
|
| 2025-07-12 00:58 | #8 | cancelled |
 Clean
|
| 2025-07-10 05:06 | #7 | processing |
Clean
|
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
name: powershell
description: This task executes a powershell command
command: ".\runcommand.ps1
command: ".\runcommand.ps1 -command {{command}} -workingDirectory {{workingDirectory}}"