926
Total Pages
755
Linux-Friendly Pages
171
Pages with Bias
18.5%
Bias Rate

Bias Trend Over Time

Pages with Bias Issues

432 issues found
Showing 26-50 of 432 flagged pages
Azure Arc Onboarding Scripts for Workload Orchestration ...azure-arc/workload-orchestration/onboarding-scripts.md
High Priority View Details →
Scanned: 2026-01-13 06:17
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Powershell Heavy 🔧 Windows Tools Missing Linux Example Windows First
Summary
The documentation is heavily biased towards Windows environments. All onboarding and setup scripts are provided as PowerShell (.ps1) scripts, with instructions to run them in a PowerShell terminal. Prerequisites use Windows-specific tooling (winget), and there are no equivalent instructions or examples for Linux/macOS users (e.g., Bash scripts, shell commands, or alternative package managers). The documentation does not mention how to run these scripts or achieve the same setup on non-Windows platforms.
Recommendations
  • Provide Bash or shell script equivalents for infra_onboarding.ps1 and cm_onboarding.ps1, or document how to run PowerShell scripts on Linux/macOS using PowerShell Core.
  • Include Linux/macOS installation instructions for prerequisites (e.g., using apt, yum, brew for Azure CLI and kubectl instead of winget).
  • Explicitly state cross-platform compatibility of the scripts, or note any limitations.
  • Show Linux/macOS command examples alongside Windows/PowerShell examples.
  • Add troubleshooting notes for common issues on Linux/macOS (e.g., file permissions, PowerShell installation).
Azure Arc Customer intent: As a system administrator managing a multi-node cluster, I want to configure Linux with HugePages and NVME modules, so that I can optimize performance for AKS Edge Essentials. ...ntainer-storage/includes/multi-node-edge-essentials.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy 🔧 Windows Tools Missing Linux Example
Summary
The documentation page presents all Linux configuration steps exclusively through Windows PowerShell commands (Invoke-AksEdgeNodeCommand), without providing native Linux shell equivalents. This assumes users are operating from a Windows environment and using Windows-specific tooling to manage Linux nodes, which may not be accessible or preferred by Linux/macOS users. There are no direct bash or shell commands shown for local execution on Linux systems.
Recommendations
  • Provide native Linux shell/bash command examples for each step, so users can execute them directly on Linux nodes.
  • Clarify whether Invoke-AksEdgeNodeCommand is required, or if manual SSH and shell commands are supported.
  • Add a section or sidebar for Linux/macOS administrators, detailing how to perform these configurations without Windows tools.
  • List Linux-native methods first, or at least in parallel, to avoid implying Windows is the primary platform.
Azure Arc Configure Machine to Manage Arc-Enabled Kubernetes Cluster ...rticles/azure-arc/edge-rag/configure-driver-machine.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Powershell Heavy 🔧 Windows Tools Windows First Missing Linux Example
Summary
The documentation is strongly biased towards Windows, providing only a PowerShell script and instructions for configuring a Windows machine. All tooling paths, downloads, and environment variable manipulations are Windows-specific, with no mention of Linux or macOS equivalents. There are no bash or shell script examples, nor guidance for non-Windows users.
Recommendations
  • Add equivalent setup instructions and sample scripts for Linux/macOS, using bash or shell scripting.
  • Provide download links and installation steps for Azure CLI, kubectl, and Helm on Linux/macOS.
  • Include notes on environment variable management for Linux/macOS (e.g., modifying ~/.bashrc or ~/.profile).
  • Clearly state cross-platform support in the introduction and link to OS-specific guides if available.
  • Ensure all critical steps (e.g., authentication, extension installation, kubeconfig setup) are covered for Linux/macOS.
Azure Arc Sample - Enable GPU for AKS on Azure Arc ...lob/main/articles/azure-arc/edge-rag/enable-gpu-aks.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Powershell Heavy 🔧 Windows Tools Missing Linux Example Windows First
Summary
The documentation exclusively provides a PowerShell script using Windows-specific tools (e.g., Get-PnpDevice, pnputil, Restart-Service), with no mention of Linux/macOS equivalents or instructions. There are no examples or guidance for enabling GPU on AKS Arc nodes running Linux, and the workflow assumes a Windows environment throughout.
Recommendations
  • Add equivalent Linux instructions and sample scripts (e.g., using lspci, lsmod, modprobe, systemctl, and relevant NVIDIA driver installation commands).
  • Clearly indicate OS requirements and whether Linux hosts are supported for this workflow.
  • Provide parity in troubleshooting and validation steps for Linux (e.g., checking GPU status, driver installation, service restarts).
  • If the feature is Windows-only, explicitly state this in the prerequisites and summary.
Azure Arc Prepare AKS Cluster on Azure Local for Edge RAG Preview Enabled by Azure Arc ...ain/articles/azure-arc/edge-rag/prepare-aks-cluster.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Powershell Heavy 🔧 Windows Tools Windows First Missing Linux Example
Summary
The documentation page demonstrates a strong Windows bias: all command-line examples use PowerShell syntax, and Windows-specific tools (e.g., Restart-Service, Start-sleep) are referenced exclusively. There are no Bash or Linux/macOS command examples, and instructions for configuring a management machine only mention Windows, omitting Linux/macOS guidance. This creates friction for users on non-Windows platforms and may prevent them from completing key steps without additional research.
Recommendations
  • Provide equivalent Bash command examples alongside PowerShell for all steps, especially for checking GPU status and managing services.
  • Include instructions and scripts for configuring a Linux/macOS machine as a driver/management host, not just Windows.
  • Reference cross-platform tools and commands (e.g., systemctl for service management on Linux) where applicable.
  • Clearly indicate which steps are platform-specific and offer alternatives for other operating systems.
  • Ensure that Azure CLI examples use syntax compatible with Bash/zsh/fish shells as well as PowerShell.
Azure Arc Billing service for Extended Security Updates for Windows Server 2012 through Azure Arc ...azure-arc/servers/billing-extended-security-updates.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First 🔧 Windows Tools Missing Linux Example
Summary
The documentation is heavily focused on Windows Server 2012 and its Extended Security Updates (ESUs) via Azure Arc, with no mention of Linux or macOS systems, examples, or equivalent scenarios. All billing, licensing, and migration guidance is specific to Windows environments and tools, and there are no cross-platform considerations or instructions for non-Windows users.
Recommendations
  • Clarify early in the documentation that the service is Windows-specific, and explicitly state whether Linux/macOS servers are supported or not.
  • If Azure Arc supports ESUs or similar billing for Linux servers, add equivalent sections, examples, and migration guidance for those platforms.
  • Provide links or references to Azure Arc documentation for Linux server management and billing, if applicable.
  • Add a comparison table or FAQ addressing differences between Windows and Linux server ESU management under Azure Arc.
Azure Arc Cloud-native licensing and cost management with Azure Arc-enabled servers ...-arc/servers/cloud-native/licensing-cost-management.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example 🔧 Windows Tools
Summary
The documentation page focuses exclusively on Windows Server and SQL Server licensing options via Azure Arc, with all examples, features, and workflows centered around Windows technologies. There are no references to Linux server licensing, Linux-specific tools, or parity in cost management for non-Windows platforms. Azure portal and Microsoft Cost Management are mentioned as central tools, but only in the context of Windows/SQL workloads.
Recommendations
  • Add sections describing licensing and cost management options for Linux servers connected to Azure Arc, if available.
  • Provide examples and workflows for Linux server onboarding, activation, and cost tracking.
  • Clarify whether pay-as-you-go or ESU-like models exist for Linux workloads, or explicitly state their absence.
  • Mention Linux-compatible update and compliance tools (e.g., Azure Update Manager for Linux) and how they integrate with Arc.
  • Ensure that introductory and summary sections acknowledge both Windows and Linux server scenarios.
Azure Arc Customer intent: "As a system administrator managing Azure Arc-enabled servers, I want to understand the required endpoints for Extended Security Updates so that I can ensure proper connectivity and compliance during installation and updates." ...azure-arc/servers/includes/esu-network-requirements.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation page focuses exclusively on Windows Server 2012 and SQL Server 2012, with all endpoint descriptions referencing Windows installation packages and Extended Security Updates for Windows products. There are no examples, instructions, or endpoint details for Linux or macOS systems, nor any mention of Linux equivalents or patterns. The page assumes a Windows-centric environment and omits guidance for non-Windows platforms.
Recommendations
  • Include endpoint requirements and examples for Linux-based Azure Arc-enabled servers, if supported.
  • Clarify whether Extended Security Updates are available for Linux workloads, and if not, explicitly state this to avoid confusion.
  • Provide parity in documentation structure by listing Linux/macOS endpoints and update mechanisms where applicable.
  • Add notes or links to Linux-specific guidance for Azure Arc-enabled servers.
Azure Arc Diagnostics of Edge-Related Logs and Errors in Workload Orchestration .../azure-arc/workload-orchestration/diagnose-problems.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example 🔧 Windows Tools
Summary
The documentation page exhibits a strong Windows bias, with all command-line and scripting examples provided exclusively in PowerShell. There are no bash, shell, or Linux/macOS-specific instructions, and file paths in JSON templates use Windows-style backslashes. The onboarding and configuration scripts are referenced as PowerShell (.ps1) files, with no mention of Linux-compatible alternatives. This creates friction for Linux/macOS users, who must adapt instructions and scripts themselves.
Recommendations
  • Provide equivalent bash/shell examples for all PowerShell commands, using az CLI and compatible syntax.
  • Offer onboarding scripts in cross-platform formats (e.g., bash, Python) or document how to run PowerShell scripts on Linux/macOS.
  • Use platform-neutral file paths in JSON templates, or provide separate examples for Windows and Linux/macOS.
  • Explicitly state OS requirements for scripts and tools, and link to instructions for installing PowerShell Core on Linux/macOS if required.
  • Ensure that all steps can be completed on Linux/macOS, and highlight any platform-specific limitations.
Azure Arc License provisioning guidelines for Extended Security Updates for Windows Server 2012 ...azure-arc/servers/license-extended-security-updates.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First 🔧 Windows Tools Missing Linux Example
Summary
The documentation is heavily focused on Windows Server environments, with all examples, scenarios, and licensing guidance tailored exclusively to Windows Server 2012 and its variants. There is no mention of Linux or macOS servers, nor any cross-platform tooling or patterns. All operational details, licensing models, and migration scenarios are described in terms of Windows Server, with references to Windows-specific technologies (e.g., MAK keys, Visual Studio subscription keys). The Azure Arc context is presented only as it relates to Windows Server ESUs, and there are no Linux or non-Windows server examples, nor guidance for mixed environments.
Recommendations
  • Explicitly state the scope is limited to Windows Server if Linux/macOS are not supported, to avoid confusion.
  • If Azure Arc ESU licensing is relevant for Linux servers, add equivalent examples and guidance for Linux environments.
  • Provide cross-platform onboarding instructions for Azure Arc, including links or references to Linux/macOS documentation.
  • Where possible, mention how mixed environments (Windows and Linux servers) should be handled in terms of ESU licensing and Azure Arc management.
  • If certain features or benefits are Windows-only, clearly call this out and direct Linux/macOS users to relevant alternatives.
Azure Arc Connect machines at scale with a Configuration Manager custom task sequence ...c/servers/onboard-configuration-manager-custom-task.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
🔧 Windows Tools Powershell Heavy Missing Linux Example Windows First
Summary
The documentation is heavily focused on Windows environments, specifically Microsoft Configuration Manager and Windows Installer (.msi) packages. All examples, instructions, and screenshots pertain to Windows tools and workflows, with exclusive use of PowerShell scripts and no mention of Linux/macOS equivalents or alternative deployment methods. There are no instructions or examples for onboarding Linux/macOS machines at scale using Configuration Manager or other cross-platform tools.
Recommendations
  • Add equivalent instructions for deploying the Connected Machine Agent to Linux/macOS devices, including supported agent packages (e.g., .deb, .rpm) and command-line installation steps.
  • Provide examples using Bash scripts or other Linux-native automation tools for connecting to Azure Arc.
  • Clarify whether Configuration Manager supports Linux/macOS onboarding at scale, and if not, suggest alternative cross-platform solutions (such as Ansible, Puppet, or Azure Automation).
  • Include screenshots and workflow steps for Linux/macOS environments where applicable.
  • Explicitly state platform limitations and link to Linux/macOS onboarding documentation if this workflow is Windows-only.
Azure Arc REST API Requests for the Run Command on Azure Arc-enabled Servers (Preview) ...ob/main/articles/azure-arc/servers/run-command-rest.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example 🔧 Windows Tools
Summary
The documentation page is heavily biased toward Windows environments. All example scenarios, scripts, and parameters are tailored for Windows Server (specifically Windows Server 2012/R2), using PowerShell cmdlets (New-NetFirewallRule) and referencing Windows-specific tools (New-AzStorageBlobSASToken). There are no examples or guidance for Linux or macOS Arc-enabled servers, nor any mention of how to execute equivalent tasks (such as configuring firewall rules) on non-Windows platforms.
Recommendations
  • Add Linux/macOS example scenarios, including REST API payloads for running bash scripts or using Linux-native firewall tools (e.g., ufw, iptables).
  • Explicitly mention support for Linux/macOS Arc-enabled servers and clarify any platform-specific limitations.
  • Provide sample scripts and instructions for generating SAS tokens using cross-platform tools (e.g., Azure CLI) rather than only PowerShell.
  • Reorder or balance examples so that Linux and Windows are equally represented, or provide parallel examples for both platforms.
Azure Arc How to troubleshoot delivery of Extended Security Updates for Windows Server 2012 through Azure Arc ...-arc/servers/troubleshoot-extended-security-updates.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Windows First Missing Linux Example 🔧 Windows Tools Powershell Heavy
Summary
The documentation is exclusively focused on troubleshooting Extended Security Updates for Windows Server 2012 via Azure Arc, with all examples, commands, and procedures tailored to Windows environments. Windows-specific tools (certutil, PowerShell), file paths, and error codes are used throughout, with no mention of Linux or macOS equivalents or scenarios. The troubleshooting steps and eligibility criteria are only applicable to Windows Server, and there are no Linux/macOS instructions or parity.
Recommendations
  • Explicitly state that the procedures are Windows-only and clarify if Linux/macOS are unsupported for this feature.
  • If Azure Arc supports Linux servers for other features, provide links or cross-references to relevant Linux troubleshooting guides.
  • Where possible, include notes or alternative procedures for Linux/macOS users, or clarify why such steps are not applicable.
  • Ensure future documentation for Azure Arc features includes Linux/macOS parity where supported, with examples and troubleshooting steps for those platforms.
Azure Arc Troubleshoot Azure Arc-enabled servers networking issues .../articles/azure-arc/servers/troubleshoot-networking.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Windows First Powershell Heavy 🔧 Windows Tools Missing Linux Example
Summary
The documentation focuses exclusively on troubleshooting TLS configuration issues for Windows servers. All examples and instructions use Windows-specific tools (PowerShell, Group Policy, Registry Editor) with no mention of Linux or macOS equivalents. There are no steps or guidance for Linux-based Arc-enabled servers, leaving Linux users without actionable troubleshooting information for cipher suite configuration.
Recommendations
  • Add a dedicated section for Linux (and optionally macOS) troubleshooting, including how to check and configure TLS cipher suites using OpenSSL, GnuTLS, or system configuration files.
  • Provide command-line examples for Linux (e.g., using openssl ciphers, editing /etc/ssl/openssl.cnf, or updating system-wide TLS settings).
  • Clarify which steps are Windows-only and offer parity for other platforms where possible.
  • Reference relevant Linux documentation or tools for managing TLS settings.
Azure Arc Deliver ESUs for SCVMM VMs through Arc ...ver-esus-for-system-center-virtual-machine-manager-vms.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First 🔧 Windows Tools Missing Linux Example
Summary
The documentation is heavily focused on Windows Server 2012/2012 R2 and System Center Virtual Machine Manager (SCVMM), both of which are Windows-only technologies. All examples, screenshots, and instructions are tailored to Windows environments, with no mention of Linux or macOS equivalents, nor any cross-platform considerations. Patch management solutions referenced are predominantly Microsoft/Windows-centric, and no Linux-specific tools or scenarios are discussed.
Recommendations
  • Clarify early in the documentation that the process is only applicable to Windows Server VMs managed by SCVMM, and that Linux/macOS VMs are not supported for ESUs in this scenario.
  • If Azure Arc supports ESU-like mechanisms for Linux VMs, provide a separate section or links to relevant documentation.
  • Where patch management solutions are discussed, explicitly mention whether non-Windows VMs can participate, and provide examples or references for Linux patching solutions if applicable.
  • Consider adding a comparison table or FAQ clarifying platform support and limitations for ESU delivery via Azure Arc.
Azure Arc Remove your SCVMM environment from Azure Arc ...virtual-machine-manager/remove-scvmm-from-azure-arc.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Powershell Heavy 🔧 Windows Tools Windows First Missing Linux Example
Summary
The documentation page exhibits notable Windows bias, primarily through the exclusive use of Windows tools and PowerShell scripts for key operations. The deboarding script is only available for Windows/PowerShell, with no Linux equivalent or instructions for Linux-based SCVMM management servers. Windows uninstall instructions are detailed and shown first, while Linux instructions are present but limited to agent removal. Critical automation steps (deboarding) are not accessible to Linux users, and all examples and tooling assume a Windows environment.
Recommendations
  • Provide a Linux-compatible deboarding script or manual CLI instructions for Linux-based SCVMM management servers.
  • Offer Bash or cross-platform CLI examples alongside PowerShell commands.
  • Clarify platform requirements and limitations for each step, especially where Windows-only tooling is used.
  • Present Linux and Windows instructions with equal prominence, possibly using side-by-side tabs.
  • Explicitly state if SCVMM management server must be Windows, or document Linux alternatives if supported.
Azure Arc Switch to the new version of Arc-enabled SCVMM ...ual-machine-manager/switch-to-the-new-version-scvmm.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example 🔧 Windows Tools
Summary
The documentation is heavily oriented toward Windows environments, with exclusive references to System Center Virtual Machine Manager (SCVMM), a Windows-only tool. All examples and instructions assume Windows infrastructure, and links to agent management are provided only for Windows. There is no mention of Linux or macOS equivalents, nor guidance for users managing non-Windows VMs.
Recommendations
  • Clarify early in the documentation that SCVMM is a Windows-only solution, and provide links or references for Linux VM management under Azure Arc if relevant.
  • Include notes or sections for users who may have Linux VMs managed through Azure Arc, outlining differences or alternative steps.
  • If agent management is required for Linux VMs, provide equivalent instructions and links for disconnecting and uninstalling Linux agents.
  • Consider adding a comparison table or FAQ addressing cross-platform scenarios and limitations.
Azure Arc Troubleshoot SCVMM-specific Azure Arc resource bridge deployment errors ...m-center-virtual-machine-manager/troubleshoot-scvmm.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
🔧 Windows Tools Powershell Heavy Missing Linux Example
Summary
The documentation page is heavily focused on troubleshooting errors related to SCVMM (System Center Virtual Machine Manager), a Windows-only tool. All error examples reference PowerShell sessions (PSSession), which are specific to Windows environments. There are no Linux or macOS troubleshooting examples, nor any mention of equivalent Linux tools or commands. This creates a clear Windows bias, as Linux users are not provided with guidance or parity for troubleshooting similar Azure Arc resource bridge deployment errors.
Recommendations
  • Explicitly state that SCVMM is a Windows-only tool and clarify platform requirements at the top of the documentation.
  • If Azure Arc resource bridge supports Linux-based management platforms, add troubleshooting steps and examples for those platforms.
  • Provide alternative troubleshooting guidance for Linux/macOS users where applicable, or link to relevant documentation.
  • Include a comparison table or section outlining differences in troubleshooting between Windows (SCVMM) and Linux-based environments.
Azure Arc Recover from accidental deletion of resource bridge VM ...em-center-virtual-machine-manager/disaster-recovery.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example 🔧 Windows Tools
Summary
The documentation exclusively provides recovery instructions and a downloadable script for Windows, using PowerShell. There are no examples, scripts, or guidance for Linux or macOS users, nor any mention of equivalent Linux tools or procedures. The recovery process is described only from the perspective of a Windows machine, creating a significant barrier for administrators using Linux or macOS.
Recommendations
  • Provide equivalent recovery instructions and scripts for Linux/macOS environments, using Bash or Python.
  • Explicitly state OS requirements and offer alternatives if the script is Windows-only.
  • Include cross-platform examples and clarify any OS-specific limitations.
  • If recovery is only possible from Windows, explain why and suggest workarounds (e.g., using a Windows VM).
Azure Arc Enable VM CRUD and power cycle operational ability in an SCVMM managed Arc-enabled server machine ...rtual-machine-manager/enable-virtual-hardware-scvmm.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
🔧 Windows Tools Windows First Missing Linux Example
Summary
The documentation is heavily focused on SCVMM (System Center Virtual Machine Manager), a Windows-only virtualization management tool. All instructions and screenshots pertain to Windows environments, with no mention of Linux or macOS equivalents, nor guidance for managing non-Windows VMs. There are no examples or steps for Linux-based management tools or command-line alternatives.
Recommendations
  • Clarify early in the document that SCVMM is a Windows-only tool and that these instructions do not apply to Linux or macOS hosts.
  • If Azure Arc supports similar VM CRUD and power cycle operations for Linux-based hypervisors (e.g., KVM, VMware on Linux), provide parallel documentation or links.
  • Include notes or sections for Linux users, outlining alternative management paths or explicitly stating limitations.
  • Provide command-line examples (e.g., Azure CLI, PowerShell Core on Linux/macOS) if possible, to improve cross-platform accessibility.
Azure Arc Onboarding Scripts for Workload Orchestration ...azure-arc/workload-orchestration/onboarding-scripts.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Powershell Heavy 🔧 Windows Tools Missing Linux Example Windows First
Summary
The documentation is heavily biased towards Windows, with all onboarding scripts and examples provided exclusively in PowerShell (.ps1) format. Prerequisites use Windows-specific tools (winget), and there are no Bash, shell, or Linux/macOS instructions or script equivalents. All example commands and instructions assume a Windows environment and PowerShell terminal, creating friction for Linux/macOS users.
Recommendations
  • Provide equivalent Bash/shell scripts for infra and CM onboarding, or document how to run the PowerShell scripts on Linux/macOS (e.g., via pwsh).
  • List Linux/macOS installation commands for prerequisites (e.g., use apt, brew, or direct downloads for Azure CLI and kubectl).
  • Include explicit notes or sections for Linux/macOS users, clarifying any differences in script execution, file paths, or environment setup.
  • Avoid using Windows-specific tools like winget in prerequisites, or provide alternatives for other platforms.
  • Present cross-platform examples side-by-side or indicate which commands/scripts are platform-specific.
Azure Arc Troubleshooting for Workload Orchestration ...es/azure-arc/workload-orchestration/troubleshooting.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Powershell Heavy 🔧 Windows Tools Missing Linux Example Windows First
Summary
The documentation page demonstrates a strong Windows bias, especially in the troubleshooting sections for workload orchestration. Most command-line examples use PowerShell syntax and Windows-specific patterns (e.g., variable assignment, piping, file encoding), with no equivalent Bash/Linux examples provided. Windows tools and conventions (such as Out-File, ConvertTo-Json, and PowerShell variable assignment) are used exclusively or explained first, making it difficult for Linux/macOS users to follow. Only the 'service groups' section provides both Bash and PowerShell tabs; all other sections are Windows-centric.
Recommendations
  • Provide Bash/Linux equivalents for all PowerShell commands, especially for az CLI, kubectl, docker, and file manipulation steps.
  • Avoid using Windows-specific tools (e.g., Out-File, ConvertTo-Json) without offering cross-platform alternatives (e.g., jq, echo, cat, > operator).
  • Document file encoding steps for Linux/macOS (e.g., using iconv or native editors).
  • Ensure variable assignment and scripting examples use syntax compatible with Bash and PowerShell, or clearly separate them.
  • Present Bash/Linux examples before or alongside PowerShell to reduce perceived Windows primacy.
Azure Arc Configure "BYOM" Endpoint Authentication for Edge RAG ...zure-arc/edge-rag/configure-endpoint-authentication.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Powershell Heavy 🔧 Windows Tools Missing Linux Example Windows First
Summary
The documentation page exclusively provides examples using Windows PowerShell syntax and references Windows-specific tools (e.g., '.\kubectl.exe'), with no equivalent Linux/macOS shell commands or guidance. All code snippets use PowerShell, and there is no mention of Bash, Linux, or macOS workflows, making it difficult for non-Windows users to follow the instructions.
Recommendations
  • Provide equivalent Bash shell examples for Linux/macOS users alongside PowerShell examples.
  • Avoid using Windows-specific executable notation (e.g., '.\kubectl.exe'); use 'kubectl' for cross-platform compatibility.
  • Explicitly mention platform differences and offer guidance for Linux/macOS environments.
  • Add notes or tabs to switch between Windows and Linux/macOS instructions.
Azure Arc How to troubleshoot delivery of Extended Security Updates for Windows Server 2012 through Azure Arc ...-arc/servers/troubleshoot-extended-security-updates.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Windows Only Powershell Heavy 🔧 Windows Tools Missing Linux Example
Summary
The documentation is exclusively focused on troubleshooting Extended Security Updates for Windows Server 2012 via Azure Arc, with all examples, commands, and instructions tailored to Windows environments. All troubleshooting steps, command-line instructions, and referenced tools (e.g., certutil, PowerShell, Windows Update Manager) are Windows-specific, with no mention of Linux or macOS equivalents, nor any guidance for non-Windows platforms. The documentation assumes the user is operating on Windows Server 2012/2012 R2, and does not address scenarios where Linux or macOS machines might be Arc-enabled or require similar troubleshooting.
Recommendations
  • Explicitly state that the guide is only applicable to Windows Server 2012/2012 R2, and clarify the scope for Linux/macOS users.
  • If Azure Arc supports Linux/macOS for other ESU or management scenarios, provide links or references to equivalent troubleshooting guides.
  • Where possible, mention whether similar certificate or update troubleshooting steps are relevant for Linux/macOS Arc-enabled machines, or state that these steps are not applicable.
  • For command-line instructions, clarify that certutil and PowerShell commands are Windows-only, and provide Linux alternatives if applicable (e.g., using OpenSSL or Linux certificate stores).
  • Add a section addressing Linux/macOS parity, even if only to state that ESU for Windows Server 2012 is not relevant for those platforms.
Azure Arc Configure Machine to Manage Arc-Enabled Kubernetes Cluster ...rticles/azure-arc/edge-rag/configure-driver-machine.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example 🔧 Windows Tools
Summary
The documentation is heavily biased towards Windows, providing only a PowerShell script and instructions for configuring a Windows machine. All examples, download links, and folder paths are Windows-specific, with no mention of Linux or macOS equivalents. There are no Bash or shell script examples, and installation instructions are tailored exclusively to Windows tools and patterns.
Recommendations
  • Add equivalent Bash or shell script examples for Linux/macOS users.
  • Provide download and installation instructions for Azure CLI, kubectl, and Helm for Linux/macOS.
  • Include notes on file paths, environment variable management, and permissions for Linux/macOS.
  • Clearly state that the process is cross-platform and provide parity in guidance and examples.