Document Details

1 Set Up Authoring Environment
Home / Scan #41 / 1 Set Up Authoring Environment
Sad Tux - Windows bias detected
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.
GitHub View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation is heavily PowerShell-centric, requiring PowerShell for both Windows and Linux users. Windows is consistently mentioned first in tables and instructions. All examples and tooling are PowerShell-based, with no mention of native Linux tools or workflows, and Linux users are required to install and use PowerShell rather than being offered alternatives.
Recommendations
  • Provide native Bash or shell-based alternatives for Linux users where possible, especially for tasks like validation, package management, and scripting.
  • Alternate the order of OS presentation, or present Linux and Windows instructions in parallel to avoid always listing Windows first.
  • Clarify if PowerShell is a strict requirement for all workflows, or if some steps can be performed using native Linux tools.
  • Include Linux-specific troubleshooting tips and considerations, especially around module compatibility and differences in PowerShell behavior on Linux.
  • Explicitly state the rationale for requiring PowerShell on Linux, and link to resources for users less familiar with PowerShell in Linux environments.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2025-07-12 23:44 #41 cancelled Biased Biased
2025-07-12 00:58 #8 cancelled Clean Clean
2025-07-10 05:06 #7 processing Clean Clean

Flagged Code Snippets

# Get a list of commands for the imported GuestConfiguration module
Get-Command -Module GuestConfiguration

# Install PSDesiredStateConfiguration version 2.0.7 (the stable release)
Install-Module -Name PSDesiredStateConfiguration -RequiredVersion 2.0.7
Import-Module -Name PSDesiredStateConfiguration

# Install the machine configuration DSC resource module from PowerShell Gallery
Install-Module -Name GuestConfiguration

# Install PSDesiredStateConfiguration prerelease version 3.0.0
Install-Module -Name PSDesiredStateConfiguration -RequiredVersion 3.0.0-beta1 -AllowPrerelease
Import-Module -Name PSDesiredStateConfiguration

# Get a list of commands for the imported PSDesiredStateConfiguration module
Get-Command -Module PSDesiredStateConfiguration