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:
⚠️
windows_first
⚠️
missing_linux_example
⚠️
powershell_heavy
⚠️
windows_tools
Summary:
The documentation exhibits several forms of Windows bias. In the section on generating wheel files, the Windows (Python 3.8) workflow is presented after the Linux (Python 3.10) workflow, but both are covered. However, in the PowerShell cmdlets section, only Windows PowerShell/Az PowerShell examples are provided for managing Python packages, with no equivalent CLI or bash/Linux-native commands. The documentation also references Windows-specific architectures (win_amd64) and tools (PowerShell), and does not provide parity for Linux users in terms of automation tooling or command-line management. There are no examples using Azure CLI, Bash, or Linux-native scripting for package management, and the PowerShell section is extensive and detailed, reinforcing a Windows-centric approach.
Recommendations:
- Provide Azure CLI and/or Bash examples for managing Python packages in Azure Automation, alongside or before PowerShell examples.
- Include Linux-native command-line workflows for package management tasks (add, list, remove, update), not just Windows/PowerShell.
- Ensure that all automation and scripting examples are available for both Windows and Linux users, or clearly indicate platform-specific limitations.
- Where possible, use cross-platform tools and commands, or provide equivalent instructions for both operating systems.
- Explicitly mention when a feature or tool is Windows-only, and suggest alternatives for Linux users.
Create pull request