Virtual Machines
1073
Total Pages
1027
Linux-Friendly Pages
46
Pages with Bias
4.3%
Bias Rate
Bias Trend Over Time
Pages with Bias Issues
284 issues found
Showing 151-175 of 284 flagged pages
Virtual Machines
Instantly access managed disk snapshots
...les/virtual-machines/disks-instant-access-snapshots.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI (bash/shell) and PowerShell examples for creating instant access snapshots, but PowerShell is presented immediately after CLI and before Resource Manager Template and Portal instructions. There are no Linux-specific tools or patterns mentioned, but the ordering of examples (CLI, PowerShell, Portal, ARM) may subtly prioritize Windows users. All CLI examples use bash syntax, which is cross-platform, but PowerShell is highlighted as a separate tab, which may reinforce Windows-centric workflows. No Linux/macOS-specific issues or missing examples are detected.
Recommendations
- Consider explicitly noting that Azure CLI commands work on Linux, macOS, and Windows, to reinforce cross-platform support.
- If possible, provide example CLI commands using both bash and PowerShell syntax, or clarify that PowerShell examples are for Windows users while CLI is for all platforms.
- Ensure that Linux/macOS users are aware that all tasks can be completed using Azure CLI, and that PowerShell is optional.
- If there are any Linux-specific considerations (e.g., file permissions, shell differences), mention them.
Create Pull Request
Virtual Machines
NVIDIA GPU Driver Extension - Azure Linux VMs
...es/virtual-machines/extensions/hpccompute-gpu-linux.md
Low Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation is primarily focused on Linux, as indicated by the title and content. However, PowerShell examples are provided alongside Azure CLI and ARM template examples, and PowerShell is presented before Azure CLI in the deployment section. There is a brief mention of a Windows extension, but no Windows-specific tools or patterns dominate the content. All technical instructions, troubleshooting, and known issues are Linux-centric, and Linux tools and commands are used throughout.
Recommendations
- Move Azure CLI examples before PowerShell examples, as CLI is cross-platform and more relevant for Linux users.
- Clarify that PowerShell examples are optional and primarily for users on Windows or those who prefer PowerShell.
- Consider adding Bash script examples for automation, as Bash is the default shell for most Linux distributions.
- Ensure that all screenshots and command snippets are clearly labeled as Linux-specific to avoid confusion.
Virtual Machines
HBv3-series virtual machine (VM) overview, architecture, topology - Azure Virtual Machines | Microsoft Docs
...main/articles/virtual-machines/hbv3-series-overview.md
Low Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation is generally cross-platform and provides technical details relevant to both Linux and Windows users. However, there is a subtle bias in the 'Recommended OS for Performance' row, which lists 'Windows Server 2019+' as the recommended OS without a Linux equivalent or guidance. Additionally, while Linux tools (like lstopo) are referenced and Linux OS support is listed, there are no explicit examples or recommendations for optimal Linux distributions or configurations, whereas Windows is specifically recommended.
Recommendations
- Add a recommended Linux distribution (or distributions) for performance parity in the 'Recommended OS for Performance' row, such as 'RHEL 8.6+', 'Ubuntu 20.04+', or similar, based on Azure's own benchmarking or support statements.
- If Windows Server 2019+ is recommended for specific features, clarify what those features are and whether equivalent features or performance can be achieved on Linux.
- Where possible, provide Linux-specific configuration tips or references, especially for HPC workloads (e.g., kernel tuning, NUMA awareness, or driver installation best practices).
Virtual Machines
Azure VM Extensions and Features for Linux
...articles/virtual-machines/extensions/features-linux.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples throughout, but PowerShell examples are always given immediately after CLI, and often with equal prominence. There is a slight 'windows_first' bias in that PowerShell (a Windows-centric tool, though now cross-platform) is always paired with CLI, and never omitted or de-emphasized. However, all examples and explanations are clearly tailored for Linux VMs, and the CLI is always presented first. No Windows-only tools or patterns are mentioned, and Linux-specific tools (like waagent) are referenced. There are no missing Linux examples, and no Windows tools are prioritized over Linux equivalents.
Recommendations
- Consider explicitly noting that Azure PowerShell is cross-platform and can be used on Linux/macOS, to avoid confusion for Linux users.
- Where possible, highlight Bash/CLI as the primary method for Linux users, and clarify PowerShell is optional.
- Add brief guidance for users who may not have PowerShell installed on Linux, linking to installation instructions.
- Ensure that CLI examples are always shown first (as is currently the case), and consider grouping PowerShell examples in a separate section for users who prefer it.
Virtual Machines
Azure Key Vault VM Extension for Linux
...rticles/virtual-machines/extensions/key-vault-linux.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation is focused on Linux, but there are several sections where Windows-oriented tools (PowerShell) are presented first or in greater detail than Linux-native equivalents. Azure PowerShell deployment instructions and troubleshooting are given before Azure CLI, and PowerShell is referenced in warnings and notes. However, Linux-specific instructions and paths are present throughout, and Azure CLI examples are provided. There are no missing Linux examples or Windows-only tools.
Recommendations
- Present Azure CLI instructions before Azure PowerShell, as CLI is more cross-platform and native to Linux/macOS.
- Add explicit notes clarifying that PowerShell is optional and not required for Linux users.
- Where warnings reference PowerShell-specific issues (e.g., escaping in settings.json), clarify that these are only relevant if using PowerShell, and provide Linux/CLI-specific troubleshooting if applicable.
- Ensure troubleshooting and support sections reference both CLI and PowerShell equally, with CLI first.
- Consider adding Bash or shell script deployment examples for Linux users, if relevant.
Virtual Machines
Create an image definition and image version
...s/blob/main/articles/virtual-machines/image-version.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides parity for both Linux and Windows throughout, with CLI and REST examples defaulting to Linux, but PowerShell examples defaulting to Windows. Windows is sometimes mentioned first in PowerShell examples, and PowerShell is given its own section with Windows-centric parameters. However, Linux is well-represented in CLI and REST, and the 'Before you begin' section lists Linux guidance first. No critical tasks are Windows-only.
Recommendations
- In PowerShell example blocks, show both Linux and Windows variants, or default to Linux as in CLI/REST.
- When listing OS-specific steps or parameters, alternate the order or clarify parity.
- Explicitly note that PowerShell can be used for Linux images, and provide a Linux example.
- Ensure that all example code blocks (especially PowerShell) demonstrate both Linux and Windows usage.
Virtual Machines
Create and upload a Red Hat Enterprise Linux VHD for use in Azure
...les/virtual-machines/linux/redhat-create-upload-vhd.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation provides comprehensive instructions for creating and uploading a Red Hat Enterprise Linux VHD for Azure across multiple hypervisors (Hyper-V, KVM, VMware, Kickstart). However, in most sections, Hyper-V (a Windows-native hypervisor) is presented first, and references to Windows tools (e.g., Hyper-V Manager, convert-vhd cmdlet) appear before Linux alternatives. The introductory notes mention Hyper-V tools before Linux/KVM/VMware, and the step-by-step guides for each RHEL version begin with Hyper-V before Linux-native options. All necessary Linux-native instructions are present, but Windows/Hyper-V is prioritized in ordering and framing.
Recommendations
- Reorder sections so that Linux-native hypervisors (KVM, VMware, Kickstart) are presented before Hyper-V, or at least alternate the order to avoid implicit prioritization.
- In introductory notes, mention Linux-native tools (e.g., qemu-img, KVM, VMware) alongside or before Windows tools like Hyper-V Manager and convert-vhd.
- Ensure that Linux-native conversion instructions (e.g., qemu-img) are as prominent as Windows/Hyper-V instructions.
- Consider adding a summary table or navigation section that equally highlights all supported hypervisors and platforms.
- Clarify that Hyper-V is not required for Linux users, and that all steps can be completed on Linux-native platforms.
Virtual Machines
Time sync for Linux VMs in Azure
...blob/main/articles/virtual-machines/linux/time-sync.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation is focused on Linux VM time sync in Azure and provides comprehensive Linux-specific guidance, examples, and commands. However, the introductory sections discuss Windows Server 2016 time sync improvements and reference Windows documentation before Linux-specific details. This is a minor 'windows_first' bias in the narrative, but all technical guidance and examples are Linux-centric.
Recommendations
- Move Windows Server 2016 discussion and links to a background or context section, or after Linux-specific information.
- Begin the page with Linux time sync context and Azure-specific Linux features before referencing Windows infrastructure.
- Ensure that Linux documentation links and examples are presented before any Windows references, unless Windows context is strictly necessary.
Virtual Machines
Share VM images in a compute gallery
...in/articles/virtual-machines/shared-image-galleries.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation covers both Linux and Windows VM images, but there are signs of Windows bias. PowerShell examples are provided alongside Azure CLI, and Windows-specific references (e.g., Sysprep, Windows upload instructions) are sometimes mentioned before Linux equivalents. Some links and examples reference Windows paths or tools first. However, Linux is also covered, and CLI examples are present.
Recommendations
- Ensure Linux and Windows examples are presented with equal prominence, alternating their order where possible.
- Provide Bash/Linux shell examples alongside PowerShell, especially in FAQ and walkthroughs.
- Where referencing upload instructions or tools, mention Linux and Windows equally and avoid defaulting to Windows-first ordering.
- Review linked pages to ensure Linux parity in referenced content.
- Clarify when a feature or step is OS-agnostic, and avoid unnecessary Windows-centric language.
Low Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation provides both Azure CLI and PowerShell examples for checking vCPU quotas, but PowerShell is featured as a primary tab, and its inclusion may be unnecessary for Linux users. The CLI example is generic and cross-platform, but PowerShell is a Windows-centric tool. There are no Linux-specific shell examples (e.g., Bash), and PowerShell is presented equally alongside CLI, which may create friction for Linux/macOS users.
Recommendations
- Clarify that PowerShell is primarily for Windows users, and Azure CLI is recommended for Linux/macOS.
- Consider presenting Azure CLI examples first, as it is cross-platform.
- Add explicit Bash shell examples or notes for Linux users, if relevant.
- Mention that PowerShell Core is available cross-platform, but most Linux users prefer CLI.
- Add a short section or note indicating which tools are best for each OS.
Low Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation provides both Azure CLI and PowerShell examples for checking vCPU quotas. However, the PowerShell section is given equal prominence to the CLI, despite PowerShell being primarily a Windows tool. The CLI example is shown first, which is positive, but the PowerShell section is still highlighted as a main method, which may create friction for Linux/macOS users who do not use PowerShell. No Linux-specific tools or shell commands are mentioned, but the CLI example is cross-platform.
Recommendations
- Clearly indicate that Azure CLI is the recommended cross-platform method for Linux/macOS users.
- Add a note clarifying that PowerShell is primarily for Windows users, and that Azure CLI works on all platforms.
- Consider providing Bash shell script examples for common quota-checking tasks, or referencing how to install Azure CLI on Linux/macOS.
- If possible, link to Azure CLI installation guides for Linux/macOS in the 'Related content' section.
Virtual Machines
Create an image definition and image version
...s/blob/main/articles/virtual-machines/image-version.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides parity between Linux and Windows in most sections, including CLI, REST, and portal instructions. However, there is a mild Windows bias in the PowerShell examples, which default to Windows OS and show Windows-specific parameters first. Additionally, in some sections, Windows is mentioned before Linux, and PowerShell examples are more prominent than Bash or Linux shell alternatives.
Recommendations
- In PowerShell examples, show both Linux and Windows OS types equally, or default to Linux where appropriate.
- Ensure that Linux and Windows examples are presented in parallel, rather than defaulting to Windows in PowerShell sections.
- Where possible, provide Bash or shell script equivalents for PowerShell commands, especially for Linux users.
- Review order of OS mentions to avoid always listing Windows first.
- Add explicit notes or examples for Linux-specific scenarios in PowerShell sections, if relevant.
Virtual Machines
Azure VM Extensions and Features for Linux
...articles/virtual-machines/extensions/features-linux.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation is generally Linux-focused and provides comprehensive guidance for Linux VM extensions in Azure. However, in several sections, Azure PowerShell examples are presented alongside Azure CLI examples, sometimes with PowerShell shown first or with equal prominence. This could create minor friction for Linux users, as PowerShell is less commonly used on Linux compared to Azure CLI. All example scripts and ARM templates are Linux-centric, and no Windows-only tools or patterns are promoted.
Recommendations
- Where both Azure CLI and PowerShell examples are shown, consider listing Azure CLI first, as it is the more common tool for Linux users.
- Explicitly note that PowerShell examples are optional for Linux users and that Azure CLI is the primary cross-platform tool.
- Where possible, provide Bash script examples for local troubleshooting or automation tasks, in addition to Azure CLI.
- If PowerShell is included, clarify its cross-platform availability but emphasize CLI for Linux workflows.
Virtual Machines
Create a Gallery for Sharing Resources
.../blob/main/articles/virtual-machines/create-gallery.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation provides examples for Azure Portal, Azure CLI, PowerShell, and REST API. PowerShell is presented as a distinct example, but it is not prioritized over cross-platform tools. However, in the 'Create a private gallery' section, the PowerShell example is shown after CLI and Portal, which is appropriate. All CLI examples use Azure CLI, which is cross-platform and works on Windows, Linux, and macOS. There are no Windows-specific tools or patterns mentioned, and Linux/macOS users are not excluded from any critical steps. The only minor bias is that PowerShell is included as a separate example, which may be unnecessary given Azure CLI's cross-platform nature, but it is not shown first.
Recommendations
- Clarify that Azure CLI is cross-platform and preferred for Linux/macOS users.
- Consider adding a note that PowerShell examples are primarily for Windows users, but PowerShell Core is available cross-platform.
- Ensure that CLI examples are always shown before PowerShell, as is currently done.
- Optionally, add Bash shell script examples for Linux users, though Azure CLI covers most needs.
Virtual Machines
NVIDIA GPU Driver Extension - Azure Linux VMs
...es/virtual-machines/extensions/hpccompute-gpu-linux.md
Low Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation is focused on Linux VM GPU driver installation, but includes PowerShell examples alongside Azure CLI and ARM templates. The PowerShell example is presented before the Azure CLI example, which is more relevant for Linux users. There is also a brief mention of a Windows extension, but it is clearly separated and not the main topic. No Windows-only tools or patterns are prioritized, and Linux-specific commands and troubleshooting are well covered.
Recommendations
- Move the Azure CLI example before the PowerShell example, as Azure CLI is more commonly used for Linux VM management.
- Clarify that PowerShell is primarily for users managing Azure from Windows environments, and highlight Azure CLI as the preferred cross-platform tool.
- Consider adding Bash shell script examples for advanced automation, if relevant.
- Ensure all screenshots and instructions are Linux-specific (which they currently are).
Virtual Machines
Azure Key Vault VM Extension for Linux
...rticles/virtual-machines/extensions/key-vault-linux.md
Low Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation is generally Linux-focused and covers Linux-specific extension details, paths, and certificate handling. However, in deployment and troubleshooting sections, Azure PowerShell examples are presented first and in greater detail, with explicit warnings about PowerShell quirks. Azure CLI examples are present but often shown after PowerShell, and troubleshooting instructions reference PowerShell before CLI. There are no missing Linux examples, but the ordering and emphasis may create friction for Linux users who typically prefer CLI or shell-based workflows.
Recommendations
- Present Azure CLI examples before PowerShell in deployment and troubleshooting sections, as CLI is more commonly used on Linux.
- Expand CLI troubleshooting instructions to match the detail provided for PowerShell.
- Add a brief note clarifying that both Azure CLI and PowerShell are supported, but CLI is recommended for Linux environments.
- Ensure all JSON and shell examples use Linux-friendly syntax and paths (which is already mostly the case).
Virtual Machines
Share VM images in a compute gallery
...in/articles/virtual-machines/shared-image-galleries.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Minor Windows Tools
Summary
The documentation covers both Linux and Windows VM images, but there are several signs of Windows bias. PowerShell examples are provided alongside Azure CLI, and Windows terminology/tools (e.g., Sysprep, Windows upload links) are often mentioned first or more prominently. In some cases, Windows-specific links or examples precede Linux equivalents, and PowerShell is referenced in feature explanations and sharing instructions. However, Linux is explicitly supported and referenced throughout, and CLI examples are present.
Recommendations
- Ensure Linux and Windows examples are given equal prominence, alternating order where possible.
- Provide Bash/Linux shell examples alongside PowerShell, especially in sections where only PowerShell is shown.
- When referencing upload or creation guides, mention Linux and Windows links together, not with Windows first.
- Clarify that both Linux and Windows tools (waagent, Sysprep) are required for generalization, and provide links for both.
- Where PowerShell is referenced for sharing or management, ensure CLI/Bash alternatives are equally visible.
Virtual Machines
Create and upload a Red Hat Enterprise Linux VHD for use in Azure
...les/virtual-machines/linux/redhat-create-upload-vhd.md
Low Priority
View Details →
Detected Bias Types
Windows First
Windows Tools
Summary
The documentation provides step-by-step instructions for preparing and uploading a Red Hat Enterprise Linux VHD for Azure using multiple hypervisors, including Hyper-V (Windows), KVM (Linux), VMware, and Kickstart. However, in most sections and workflows, Hyper-V (a Windows-based tool) is presented first, and Windows-centric terminology (e.g., Hyper-V Manager, VHD conversion using Windows tools) is prominent. Linux alternatives (KVM, VMware, Kickstart) are covered in detail, but Windows/Hyper-V instructions are consistently prioritized and referenced as the primary workflow. Some conversion steps mention Windows tools (e.g., Hyper-V Manager, convert-vhd cmdlet) before Linux equivalents (e.g., qemu-img), and the overall structure puts Windows/Hyper-V steps before Linux/KVM/VMware steps.
Recommendations
- Reorder sections so that Linux-native hypervisors (KVM, VMware, Kickstart) are presented before or alongside Hyper-V, rather than always after.
- Where disk conversion is discussed, mention Linux tools (qemu-img) before or alongside Windows tools (Hyper-V Manager, convert-vhd).
- Add a summary table or navigation at the top to help Linux users quickly find their relevant workflow.
- Ensure that Linux-specific terminology and tools are not overshadowed by Windows/Hyper-V references.
- Consider adding explicit notes that all workflows are equally supported, and none is preferred based on OS.
Virtual Machines
Time sync for Linux VMs in Azure
...blob/main/articles/virtual-machines/linux/time-sync.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation is focused on Linux VM time synchronization in Azure and provides Linux-specific guidance and examples. However, the introductory section discusses Windows Server 2016 time sync improvements and references Windows documentation before Linux-specific details. All configuration instructions, tools, and examples are Linux-centric, with no PowerShell or Windows tool bias in the main content. The only minor bias is mentioning Windows infrastructure and linking to Windows docs first, which may be unnecessary for Linux users.
Recommendations
- Move or minimize Windows Server 2016 discussion to a background or context section, clarifying its relevance to Linux VM time sync.
- Prioritize Linux-specific information and links in the introduction.
- Add a brief explanation that Windows infrastructure is relevant only as the underlying Azure host, not for Linux VM configuration.
- Ensure Linux documentation links are given equal or greater prominence compared to Windows links.
Virtual Machines
Enable InfiniBand on HPC VMs - Azure Virtual Machines | Microsoft Docs
...icles/virtual-machines/extensions/enable-infiniband.md
Low Priority
View Details →
Detected Bias Types
Windows Tools
Powershell Heavy
Windows First
Summary
The documentation covers both Linux and Windows, but there is mild Windows bias in the VM extension section, where Azure PowerShell is mentioned as the primary tool for adding extensions, with no mention of Azure CLI or ARM templates. Windows VM extension details are given before Linux in that section. However, Linux examples are provided for manual driver installation and IPoIB configuration, and Linux VM images are highlighted first.
Recommendations
- Add Azure CLI and ARM template examples for adding VM extensions, alongside PowerShell.
- Mention Linux tools and workflows equally when discussing VM extension management.
- Consider presenting Linux and Windows instructions in parallel or with equal prominence.
- Provide a Windows example for manual driver installation, similar to the Linux example, or clarify if manual install is not recommended on Windows.
Virtual Machines
Azure VM Extensions and Features for Linux
...articles/virtual-machines/extensions/features-linux.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all major extension management tasks. However, Azure PowerShell is a Windows-centric tool, and its inclusion alongside Azure CLI (which is cross-platform) may create friction for Linux/macOS users. Additionally, in some sections, PowerShell examples are presented before or equally with CLI, rather than prioritizing CLI for a Linux-focused audience. No critical Linux information is missing, and all examples are relevant to Linux VMs, but the parity could be improved by emphasizing CLI and de-emphasizing PowerShell.
Recommendations
- Prioritize Azure CLI examples before PowerShell in all code tabs and narrative, as CLI is cross-platform and native for Linux users.
- Clearly indicate that Azure PowerShell is optional and primarily for users who prefer it, rather than presenting it as an equal or default choice.
- Where possible, provide Bash-native or shell script examples for common extension operations, especially for troubleshooting or log analysis.
- Consider omitting PowerShell examples from the main flow, or placing them in expandable sections, to reduce cognitive load for Linux-focused readers.
Virtual Machines
NVIDIA GPU Driver Extension - Azure Linux VMs
...es/virtual-machines/extensions/hpccompute-gpu-linux.md
Low Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation is focused on Linux VM GPU driver installation, but includes PowerShell examples for deploying the extension and troubleshooting, and presents PowerShell before Azure CLI in some sections. While Azure CLI and ARM template examples are provided, the inclusion and ordering of PowerShell (a Windows-centric tool) may create friction for Linux users. No Windows-specific tools or patterns are exclusively mentioned, and Linux-specific commands and troubleshooting are well covered.
Recommendations
- Move Azure CLI examples before PowerShell in all sections to prioritize Linux-native tooling.
- Clearly indicate that PowerShell is optional and primarily for Windows users, while Azure CLI is recommended for Linux/macOS.
- Consider adding Bash script examples for common operations, especially for troubleshooting.
- Where PowerShell is used, provide equivalent Bash or shell commands for Linux users.
- Review screenshots and UI instructions to ensure they are Linux-appropriate (though current ones appear to be).
Virtual Machines
Azure Key Vault VM Extension for Linux
...rticles/virtual-machines/extensions/key-vault-linux.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation is focused on Linux, but there are some minor Windows biases. Azure PowerShell deployment instructions and troubleshooting are presented before Azure CLI equivalents, and PowerShell examples are given with more detail. The note about Key Vault access policy links to a Windows VM-specific article, even though the extension is Linux-focused. However, all critical tasks are fully documented for Linux users, and Linux-specific paths, tools, and behaviors are clearly described.
Recommendations
- Present Azure CLI instructions before PowerShell, as CLI is cross-platform and preferred by many Linux users.
- Add links to Linux-specific managed identity and Key Vault access policy configuration guides, rather than referencing Windows VM portal articles.
- Ensure troubleshooting sections highlight CLI commands equally or before PowerShell.
- Where possible, clarify that PowerShell is optional and not required for Linux users.
Virtual Machines
Create an image definition and image version
...s/blob/main/articles/virtual-machines/image-version.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides parity between Linux and Windows in most sections, including CLI and REST examples. However, in the PowerShell section, Windows is presented first and as the default, with Linux mentioned only as an alternative. Additionally, PowerShell examples are shown alongside CLI, but CLI is not shown first or exclusively. Overall, the bias is minor and does not prevent Linux/macOS users from completing the task.
Recommendations
- In PowerShell examples, show Linux as the default or provide a Linux-specific example first, or clarify that PowerShell can be used for both OS types.
- Ensure that CLI examples (which are cross-platform) are presented before PowerShell, or at least equally, to avoid implying Windows is the default.
- Explicitly state that all steps and tools (CLI, REST) are fully supported on Linux/macOS, and provide links to Linux-specific guidance where relevant.
- Where possible, provide sample commands for both Linux and Windows in PowerShell and CLI sections.