Aks

535
Total Pages
430
Linux-Friendly Pages
105
Pages with Bias
19.6%
Bias Rate

Bias Trend Over Time

Pages with Bias Issues

365 issues found
Showing 176-200 of 365 flagged pages
Aks Kubernetes on Azure tutorial - Upgrade an Azure Kubernetes Service (AKS) cluster ...in/articles/aks/tutorial-kubernetes-upgrade-cluster.md
Low Priority View Details →
Scanned: 2026-02-09 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Powershell Heavy Windows First
Summary
The documentation provides parity between Azure CLI, Azure PowerShell, and Azure portal instructions for all major tasks. However, Azure PowerShell is featured equally alongside Azure CLI, which may create friction for Linux/macOS users since PowerShell is primarily a Windows tool (though it is available cross-platform). Additionally, PowerShell examples are sometimes given before or alongside CLI examples, and the page metadata includes 'devx-track-azurepowershell', suggesting a slight Windows bias. No critical steps are Windows-only, and Linux users can complete all tasks using Azure CLI or portal.
Recommendations
  • Clearly indicate that Azure PowerShell is optional and that Azure CLI is the recommended cross-platform tool.
  • Present Azure CLI examples before PowerShell examples in each section to prioritize Linux/macOS parity.
  • Add a brief note at the start explaining that Azure PowerShell is available cross-platform but is most commonly used on Windows.
  • Consider removing or minimizing references to PowerShell in page metadata unless necessary.
GitHub Create Pull Request
Aks Azure Kubernetes Service (AKS) Managed Gateway API Installation ...aks-docs/blob/main/articles/aks/managed-gateway-api.md
Low Priority View Details →
Scanned: 2026-02-09 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation primarily uses Azure CLI commands (az), which are cross-platform, but does not provide explicit Linux/macOS guidance or examples. There is no mention of Windows-specific tools, but the use of Azure CLI and kubectl is shown without clarifying OS-specific installation or usage. No PowerShell or Windows-only commands are present, but the order and phrasing may imply Windows-first bias by not acknowledging Linux/macOS users or their potential needs.
Recommendations
  • Add explicit notes clarifying that Azure CLI and kubectl commands work on Linux, macOS, and Windows.
  • Provide links or instructions for installing Azure CLI and kubectl on Linux/macOS.
  • Mention any OS-specific considerations (such as environment variable syntax differences) where relevant.
  • Ensure that output examples and command syntax are not Windows-centric (e.g., avoid Windows-style environment variables or file paths).
GitHub Create Pull Request
Aks Develop on Azure Kubernetes Service (AKS) with Helm ...ure-aks-docs/blob/main/articles/aks/quickstart-helm.md
Low Priority View Details →
Scanned: 2026-02-09 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Powershell Heavy Windows First
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all Azure-related operations, but consistently presents PowerShell examples alongside CLI, and sometimes before Linux-native alternatives. There is no explicit Linux bias, but the presence of PowerShell examples and references may create friction for Linux/macOS users, especially since Azure PowerShell is primarily used on Windows. However, all critical tasks are covered with Azure CLI (cross-platform) and bash commands, ensuring Linux parity.
Recommendations
  • Consider clarifying that Azure PowerShell is primarily for Windows users and that Azure CLI is recommended for Linux/macOS.
  • Present Azure CLI examples first in each section, as it is cross-platform and more commonly used on Linux/macOS.
  • Optionally, add a note that Azure PowerShell can be installed on Linux/macOS, but Azure CLI is generally preferred.
  • Ensure that any PowerShell-specific instructions do not overshadow or precede CLI/bash instructions.
  • Review the 'ms.custom' metadata to ensure it does not imply PowerShell is the primary path.
GitHub Create Pull Request
Aks Access Kubernetes Resources using the Azure Portal ...e-aks-docs/blob/main/articles/aks/kubernetes-portal.md
Low Priority View Details →
Scanned: 2026-02-08 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both Azure CLI (Linux/macOS-friendly) and Azure PowerShell (Windows-centric) examples for troubleshooting IP range configuration, but consistently presents PowerShell examples immediately after CLI, and sometimes with more detail. There are no Windows-only tools or patterns, but PowerShell is given equal prominence, which may be unnecessary for cross-platform parity. The rest of the documentation is portal-centric and platform-neutral.
Recommendations
  • Ensure Azure CLI examples are presented first and with equal or greater detail than PowerShell, as CLI is cross-platform.
  • Explicitly note that Azure CLI works on Linux/macOS/Windows, while PowerShell is Windows-centric.
  • Consider providing Bash-native commands for IP retrieval (e.g., `curl ifconfig.me`) as alternatives to `dig`, which may not be installed by default.
  • Clarify that all portal steps are platform-agnostic.
  • If PowerShell is included, ensure it is clearly marked as Windows-specific and not required for Linux/macOS users.
GitHub Create Pull Request
Aks Azure Kubernetes Service (AKS) Managed Gateway API Installation ...aks-docs/blob/main/articles/aks/managed-gateway-api.md
Low Priority View Details →
Scanned: 2026-02-08 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation primarily uses Azure CLI commands and kubectl examples, which are cross-platform. However, there is a subtle bias in that Azure CLI examples are shown first and exclusively, with no mention of Linux-specific shell patterns or macOS considerations. There are no PowerShell or Windows-only commands, but the documentation assumes the reader is comfortable with Azure CLI and does not provide alternative instructions for Linux-native tools or package managers (e.g., apt, yum, brew) for installing prerequisites. Additionally, there is no explicit mention that all commands work equally on Linux/macOS, which could create uncertainty for non-Windows users.
Recommendations
  • Explicitly state that Azure CLI and kubectl commands are cross-platform and supported on Linux/macOS.
  • Provide links or brief instructions for installing Azure CLI and kubectl on Linux/macOS.
  • Mention any OS-specific considerations (such as environment variable syntax differences or shell requirements) if relevant.
  • Include example commands for updating/installing Azure CLI using Linux package managers (apt, yum, brew) alongside the az extension commands.
GitHub Create Pull Request
Aks Deploy an application with the Dapr cluster extension for Azure Kubernetes Service (AKS) or Arc-enabled Kubernetes ...ure-aks-docs/blob/main/articles/aks/quickstart-dapr.md
Low Priority View Details →
Scanned: 2026-02-08 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell options for resource cleanup, but Azure PowerShell is mentioned alongside Azure CLI in prerequisites and as an alternative for resource deletion. There are no Windows-only tools or commands used elsewhere, and all main deployment steps use cross-platform tools (kubectl, curl, git). However, Azure PowerShell is referenced equally with Azure CLI, which may create minor friction for Linux/macOS users, as PowerShell is less commonly installed or used on those platforms.
Recommendations
  • Make Azure CLI the default and primary example for resource cleanup, with PowerShell as a secondary option.
  • Clarify that Azure PowerShell is optional and primarily for Windows users, while Azure CLI is cross-platform.
  • Consider providing Bash shell examples for common operations if relevant.
  • Ensure that all steps can be completed using Azure CLI and kubectl, without requiring PowerShell.
GitHub Create Pull Request
Aks Certificate Rotation in Azure Kubernetes Service (AKS) ...ks-docs/blob/main/articles/aks/certificate-rotation.md
Low Priority View Details →
Scanned: 2026-02-08 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation provides both Linux and Windows file paths for verifying TLS Bootstrapping, but in most sections, examples and commands are generic and platform-neutral (using Azure CLI and kubectl). However, in the 'Verify TLS Bootstrapping is enabled on current agent node pool' section, the Windows path is mentioned alongside the Linux path, but Linux is listed first. There are no PowerShell-specific examples, and all shell commands use bash syntax. No Windows tools or patterns are mentioned exclusively or before Linux equivalents. However, there is a minor bias in that the Windows path is only mentioned in one section, and no explicit Linux-specific troubleshooting or examples are given elsewhere.
Recommendations
  • Ensure that Linux and Windows paths are always provided together when relevant, and clarify any OS-specific steps.
  • Add explicit notes or troubleshooting steps for Linux users where applicable, especially for file access or certificate management.
  • Consider including example outputs for both Linux and Windows environments to improve parity.
  • If there are any OS-specific limitations or behaviors, document them clearly.
GitHub Create Pull Request
Aks Install and Use the Agentic CLI for Azure Kubernetes Service (AKS) (Preview) ...cs/blob/main/articles/aks/cli-agent-for-aks-install.md
Low Priority View Details →
Scanned: 2026-02-08 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation generally maintains good cross-platform parity, but there are subtle signs of Windows bias. In the Docker daemon startup instructions, macOS/Windows (Docker Desktop) is mentioned before Linux, and no Linux desktop environment is referenced. The verification steps for Docker cleanup use 'ls ~/.azure/aksAgent.config' and 'docker images | grep aks-agent', which are Unix-style commands, but no PowerShell/Windows Command Prompt equivalents are provided. However, the documentation does not provide explicit PowerShell or Windows Command Prompt examples for Azure CLI commands, which are cross-platform. The overall flow and examples are CLI-centric and mostly platform-neutral, but the ordering and some phrasing may create minor friction for Linux users.
Recommendations
  • In Docker daemon startup instructions, mention Linux first or equally, and clarify that Docker Desktop is not available for Linux.
  • Provide PowerShell/Windows Command Prompt equivalents for verification commands (e.g., checking for config files and Docker images) to ensure parity for Windows users.
  • Explicitly state that all Azure CLI commands work on Linux, macOS, and Windows, and link to platform-specific installation guides for Docker and Azure CLI.
  • Where file paths are referenced (e.g., ~/.azure/aksAgent.config), clarify the Windows equivalent (e.g., %USERPROFILE%\.azure\aksAgent.config).
GitHub Create Pull Request
Aks Configure Azure CNI Networking in Azure Kubernetes Service (AKS) ...aks-docs/blob/main/articles/aks/configure-azure-cni.md
Low Priority View Details →
Scanned: 2026-02-08 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Powershell Heavy Windows First
Summary
The documentation provides examples for Azure portal, Azure PowerShell, and Azure CLI. The PowerShell section is detailed and includes instructions for installing/upgrading PowerShell on Windows, macOS, and Linux, but the PowerShell-centric workflow and terminology may be more familiar to Windows users. In the prerequisites, PowerShell is listed before CLI, and PowerShell-specific instructions are more verbose. However, Azure CLI examples are provided and are cross-platform. No critical steps are Windows-only, and Linux/macOS users can complete all tasks.
Recommendations
  • Ensure parity in example detail between Azure PowerShell and Azure CLI sections.
  • Consider listing Azure CLI before PowerShell in prerequisites and configuration sections, as CLI is more universally cross-platform.
  • Add explicit notes highlighting that both Azure PowerShell and Azure CLI are fully supported on Linux and macOS, and link to installation guides for all platforms.
  • Balance the verbosity of PowerShell instructions with CLI instructions to avoid perceived preference.
GitHub Create Pull Request
Aks Troubleshoot the Agentic CLI for Azure Kubernetes Service (AKS) ...ob/main/articles/aks/cli-agent-for-aks-troubleshoot.md
Low Priority View Details →
Scanned: 2026-02-08 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation provides troubleshooting steps for the agentic CLI for AKS and includes platform-specific guidance for Docker issues. Windows/macOS instructions are often listed before Linux, and Windows-specific tooling (Docker Desktop) is referenced. However, Linux commands are included for most scenarios. There are no PowerShell examples, but Windows/macOS solutions are sometimes prioritized. Azure CLI and kubectl commands are cross-platform, but some troubleshooting steps (e.g., Docker Desktop) are Windows/macOS-centric, and Linux solutions are sometimes less detailed.
Recommendations
  • Present Linux, macOS, and Windows instructions in parallel or in a consistent order (e.g., Linux first, then macOS, then Windows) to avoid implicit prioritization.
  • Expand Linux troubleshooting steps for Docker Desktop alternatives (e.g., mention dockerd or other Linux-specific Docker management tools).
  • Ensure all platform-specific instructions are equally detailed and clear.
  • Where possible, clarify if a solution applies to all platforms or only to Windows/macOS.
  • Add explicit notes for macOS/Linux users when a step is Windows-specific (e.g., Docker Desktop).
GitHub Create Pull Request
Aks Install the Dapr extension for Azure Kubernetes Service (AKS) and Arc-enabled Kubernetes ...softDocs/azure-aks-docs/blob/main/articles/aks/dapr.md
Low Priority View Details →
Scanned: 2026-02-08 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Powershell Heavy Windows First
Summary
The documentation is generally cross-platform, focusing on Azure CLI and Bicep for installation and management, which are available on Windows, Linux, and macOS. However, in the 'Listing the CRDs in your cluster' section, the example uses 'kubectl get crds | findstr dapr.io', which is a Windows/PowerShell pattern. No Linux/macOS equivalent (e.g., using 'grep') is provided. Additionally, the use of Azure CLI is shown with interactive shell prompts that may be more familiar to Windows users, but the CLI itself is cross-platform.
Recommendations
  • Provide Linux/macOS equivalent for CRD listing, e.g., 'kubectl get crds | grep dapr.io'.
  • When showing shell commands, clarify that Azure CLI works on all platforms and, where relevant, show both Windows and Linux/macOS shell syntax.
  • Review other command examples for platform-specific patterns and add parity where needed.
GitHub Create Pull Request
Aks Create an internal load balancer ...s/azure-aks-docs/blob/main/articles/aks/internal-lb.md
Low Priority View Details →
Scanned: 2026-02-08 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
🔧 Windows Tools Windows First
Summary
The documentation provides both Azure CLI and PowerShell options for prerequisite cluster creation and subnet listing, but references to PowerShell are present alongside Azure CLI in the 'Before you begin' section and for subnet listing. Azure CLI is used for all main walkthrough steps and examples, but PowerShell is mentioned as an alternative tool for some Azure operations. There are no Linux-specific examples or explicit Linux parity notes. The order of tools sometimes puts PowerShell before Azure CLI or at least equally, which may subtly suggest Windows familiarity. However, all critical steps use cross-platform tools (kubectl, Azure CLI), and Linux/macOS users can complete the tasks without friction.
Recommendations
  • Clarify that Azure CLI is cross-platform and preferred for Linux/macOS users.
  • Where PowerShell is mentioned, explicitly note that Azure CLI is available and recommended for Linux/macOS.
  • Consider providing Linux/macOS-specific command examples or notes where Azure CLI is used.
  • If referencing PowerShell, always list Azure CLI first and clarify its cross-platform nature.
  • Add a brief note in 'Before you begin' that all main steps use cross-platform tools and are suitable for Linux/macOS.
GitHub Create Pull Request
Aks Configure LocalDNS in Azure Kubernetes Service (AKS) ...ure-aks-docs/blob/main/articles/aks/localdns-custom.md
Low Priority View Details →
Scanned: 2026-02-08 00:00
Reviewed by: LLM Analysis
Issues: 1 bias type
Detected Bias Types
Windows First
Summary
The documentation provides links for creating an AKS cluster using Azure CLI, Azure PowerShell, and Azure portal, with PowerShell mentioned alongside CLI and portal. However, all configuration, verification, and troubleshooting examples use cross-platform tools (Azure CLI, kubectl, YAML), and the feature itself is only supported on Azure Linux or Ubuntu node pools. There are no PowerShell-specific commands or Windows-only tools used in the main instructions. The only minor bias is the mention of Azure PowerShell as a cluster creation option, which is listed alongside CLI and portal, but no PowerShell-specific examples are provided.
Recommendations
  • Ensure that Linux/macOS users are aware that Azure CLI and kubectl commands are fully cross-platform.
  • Consider clarifying that Azure PowerShell is primarily for Windows users, and recommend Azure CLI for Linux/macOS.
  • If possible, list Azure CLI as the primary option for cluster creation, with PowerShell as an alternative for Windows users.
  • Add a note that all configuration and verification steps are cross-platform and do not require Windows tools.
GitHub Create Pull Request
Aks Develop on Azure Kubernetes Service (AKS) with Helm ...ure-aks-docs/blob/main/articles/aks/quickstart-helm.md
Low Priority View Details →
Scanned: 2026-02-08 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all Azure-related operations, but consistently presents PowerShell examples alongside CLI, and sometimes references Azure PowerShell in prerequisites and custom metadata. There is no explicit Windows-only content, but PowerShell is a Windows-centric tool, and its inclusion may create friction for Linux/macOS users. However, all critical steps are covered with Azure CLI (cross-platform), and shell/bash commands are used for Helm and kubectl operations.
Recommendations
  • Consider clarifying that Azure PowerShell is primarily for Windows users, and Azure CLI is recommended for Linux/macOS.
  • Present Azure CLI examples first in each section, as it is cross-platform.
  • Add explicit notes or guidance for Linux/macOS users, e.g., 'Azure CLI is recommended for Linux/macOS environments.'
  • Optionally, provide bash/zsh shell script snippets for common tasks, or link to Linux/macOS-specific guides.
  • Remove Azure PowerShell from prerequisites for Linux/macOS users, or clarify its platform relevance.
GitHub Create Pull Request
Aks Secure Pod Traffic with Network Policies in Azure Kubernetes Service (AKS) ...ks-docs/blob/main/articles/aks/use-network-policies.md
Low Priority View Details →
Scanned: 2026-02-08 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both Linux and Windows examples for AKS network policy management, but Windows-specific instructions (such as registering feature flags and creating Windows admin credentials) are presented in dedicated sections and sometimes before Linux equivalents. All CLI examples use Azure CLI and Bash, which are cross-platform, but there are no PowerShell-specific examples. The documentation does not show a strong bias, but Windows instructions are prominent and sometimes appear before Linux instructions, creating minor friction for Linux/macOS users.
Recommendations
  • Ensure Linux instructions are presented first in sections where both Linux and Windows are supported.
  • Add explicit notes clarifying which steps are platform-specific and which are cross-platform.
  • Consider providing PowerShell examples for Windows users alongside Bash examples for Linux/macOS users.
  • Clearly separate Windows-only content from Linux content to avoid confusion.
GitHub Create Pull Request
Aks Install the Dapr extension for Azure Kubernetes Service (AKS) and Arc-enabled Kubernetes ...softDocs/azure-aks-docs/blob/main/articles/aks/dapr.md
Low Priority View Details →
Scanned: 2026-02-05 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Powershell Heavy Windows First
Summary
The documentation is generally cross-platform, focusing on Azure CLI and Bicep for installation and management of the Dapr extension on AKS and Arc-enabled Kubernetes clusters. However, there is a minor Windows bias in the troubleshooting section, where the example for listing CRDs uses PowerShell's 'findstr' command with 'kubectl', which is specific to Windows. Additionally, the example is shown without a Linux/macOS equivalent, and the PowerShell example appears first and exclusively.
Recommendations
  • Provide Linux/macOS equivalents for shell commands, such as using 'grep' instead of 'findstr' (e.g., 'kubectl get crds | grep dapr.io').
  • Where shell commands are shown, present both Windows (PowerShell) and Linux/macOS (bash/zsh) examples side-by-side or in tabs.
  • Add a note clarifying that the command syntax may differ between Windows and Linux/macOS environments.
  • Review other command examples to ensure none are inadvertently Windows-specific.
GitHub Create Pull Request
Aks Deploy an application with the Dapr cluster extension for Azure Kubernetes Service (AKS) or Arc-enabled Kubernetes ...ure-aks-docs/blob/main/articles/aks/quickstart-dapr.md
Low Priority View Details →
Scanned: 2026-02-05 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell instructions for resource cleanup, but lists Azure CLI first. PowerShell is mentioned as an alternative for Azure management, but all operational and application deployment examples use cross-platform tools (kubectl, curl, git). No Windows-only tools or patterns are required, and Linux/macOS users can follow the guide without friction.
Recommendations
  • Continue listing Azure CLI before PowerShell, as CLI is cross-platform and preferred for Linux/macOS users.
  • Consider explicitly noting that all kubectl, curl, and git commands work on Linux/macOS and Windows.
  • If possible, clarify that Azure PowerShell is optional and primarily for users who prefer PowerShell environments.
  • Ensure any future examples or screenshots do not assume Windows-only environments (e.g., avoid showing Windows terminal exclusively).
GitHub Create Pull Request
Aks Install and Use the Agentic CLI for Azure Kubernetes Service (AKS) (Preview) ...cs/blob/main/articles/aks/cli-agent-for-aks-install.md
Low Priority View Details →
Scanned: 2026-02-05 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation provides installation and usage instructions for the agentic CLI for AKS, with examples and guidance for both client and cluster modes. While the core CLI commands are cross-platform, there is a subtle Windows bias in several areas: Docker startup instructions list macOS/Windows (Docker Desktop) before Linux (systemctl), and verification steps for Docker cleanup reference the Windows/macOS path (~/.azure/aksAgent.config) without clarifying Linux differences. There are no PowerShell-specific examples, but the ordering and phrasing often prioritize Windows/macOS approaches before Linux equivalents. Some verification steps (e.g., checking for Docker Desktop icon) are not relevant for Linux users, and Linux-specific troubleshooting is less detailed.
Recommendations
  • Present Linux instructions and examples alongside or before Windows/macOS instructions, especially for Docker startup and verification.
  • Clarify file paths and configuration locations for Linux users (e.g., ~/.azure/aksAgent.config may differ on Linux).
  • Add troubleshooting notes for common Linux issues (such as permissions, systemd status, or SELinux/AppArmor).
  • Explicitly state that all az CLI commands work on Linux, macOS, and Windows, and provide any OS-specific caveats.
  • Where Docker Desktop is referenced, add a note about Linux alternatives (e.g., dockerd, podman compatibility if relevant).
GitHub Create Pull Request
Aks Configure Azure CNI Networking in Azure Kubernetes Service (AKS) ...aks-docs/blob/main/articles/aks/configure-azure-cni.md
Low Priority View Details →
Scanned: 2026-02-05 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides parallel instructions for Azure portal, Azure PowerShell, and Azure CLI. However, the PowerShell section is presented before the CLI section, and there is a notable emphasis on Azure PowerShell, which is a Windows-centric tool (though it is cross-platform). The PowerShell section includes more detailed setup instructions and troubleshooting for different OSes, but the CLI section is more concise. There are no missing Linux examples, and both CLI and PowerShell are supported on Linux/macOS, but the ordering and depth of PowerShell coverage may create a slight perception of Windows bias.
Recommendations
  • Present Azure CLI instructions before Azure PowerShell, as CLI is more universally used across platforms.
  • Ensure that setup and troubleshooting instructions for CLI are as detailed as those for PowerShell, including explicit notes for Linux/macOS users.
  • Clarify in the PowerShell section that Azure PowerShell is cross-platform and provide equal prominence to Linux/macOS installation and usage.
  • Consider combining or cross-referencing PowerShell and CLI sections where possible to reduce perceived bias.
GitHub Create Pull Request
Aks Troubleshoot the Agentic CLI for Azure Kubernetes Service (AKS) ...ob/main/articles/aks/cli-agent-for-aks-troubleshoot.md
Low Priority View Details →
Scanned: 2026-02-05 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation generally provides troubleshooting steps for both Windows/macOS and Linux users. However, in the Docker-related troubleshooting section, instructions for starting Docker on Windows/macOS (via Docker Desktop) are presented before Linux commands. Additionally, for permission issues, Windows/macOS users are told to restart Docker Desktop, while Linux users receive more detailed command-line instructions. No PowerShell-specific commands are present, but the pattern of mentioning Windows/macOS solutions before Linux ones is consistent. All Azure CLI and kubectl examples are cross-platform.
Recommendations
  • Present Linux and Windows/macOS troubleshooting steps in parallel or in a consistent order (e.g., Linux first, then Windows/macOS, or vice versa).
  • Provide equally detailed instructions for both platforms (e.g., explain how to restart Docker Desktop and how to restart the Docker daemon on Linux).
  • Explicitly state that all CLI commands work on Linux, macOS, and Windows (with WSL or Azure CLI installed), to reassure non-Windows users.
  • Consider adding a note about platform differences in Docker installation and management.
GitHub Create Pull Request
Aks Create an internal load balancer ...s/azure-aks-docs/blob/main/articles/aks/internal-lb.md
Low Priority View Details →
Scanned: 2026-02-05 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
🔧 Windows Tools Windows First
Summary
The documentation provides both Azure CLI and PowerShell options for prerequisite steps, but references to PowerShell (Get-AzVirtualNetworkSubnetConfig) and Azure PowerShell quickstart are given alongside or before Linux equivalents. The main workflow and all code samples use kubectl and Azure CLI, which are cross-platform, but PowerShell is mentioned as a tool for some resource queries. There are no Linux/macOS-specific examples or explicit parity notes.
Recommendations
  • When listing prerequisite tools, mention Azure CLI as the primary cross-platform tool and clarify that PowerShell is optional for Windows users.
  • Where PowerShell commands are referenced (e.g., for listing subnets), provide equivalent Azure CLI commands first and clearly indicate cross-platform compatibility.
  • Consider adding a note that all main steps (kubectl, Azure CLI) work on Linux/macOS and Windows, and provide links to installation guides for each OS.
  • If mentioning PowerShell, always pair it with the Azure CLI equivalent and avoid implying PowerShell is required for Linux/macOS users.
GitHub Create Pull Request
Aks Access Kubernetes Resources using the Azure Portal ...e-aks-docs/blob/main/articles/aks/kubernetes-portal.md
Low Priority View Details →
Scanned: 2026-02-05 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both Azure CLI (cross-platform) and Azure PowerShell (Windows-centric) instructions for updating AKS API server authorized IP ranges, but the Azure CLI tab is presented first. No Linux- or macOS-specific instructions are missing, and all critical tasks can be completed using the Azure Portal or Azure CLI. However, the inclusion of Azure PowerShell examples may create a slight Windows bias, especially if users perceive PowerShell as the default or preferred method.
Recommendations
  • Clarify that Azure CLI is cross-platform and works on Windows, Linux, and macOS, while Azure PowerShell is primarily for Windows users.
  • Consider adding a note for Linux/macOS users to use Azure CLI, and for Windows users to choose either Azure CLI or PowerShell.
  • Ensure that Azure CLI examples are always shown first (as is currently the case), and that PowerShell is clearly marked as optional for Windows users.
  • If possible, add a brief mention that all portal-based actions are OS-agnostic.
GitHub Create Pull Request
Aks Secure Pod Traffic with Network Policies in Azure Kubernetes Service (AKS) ...ks-docs/blob/main/articles/aks/use-network-policies.md
Low Priority View Details →
Scanned: 2026-02-05 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First 🔧 Windows Tools
Summary
The documentation provides both Linux and Windows examples for AKS network policies, but Windows-specific instructions (such as administrator credential creation and feature flag registration) are presented in detail and before Linux equivalents in some sections. Windows tools and patterns (e.g., HNS ACLPolicy) are described alongside Linux tools (IPTables/BPF), but Windows-specific steps are sometimes more prominent. The main workflow and CLI examples are cross-platform, but the ordering and emphasis can create minor friction for Linux/macOS users.
Recommendations
  • Present Linux and Windows instructions in parallel or clearly separated sections, with Linux examples shown first where appropriate.
  • Ensure Linux-specific limitations and steps are as detailed as Windows equivalents.
  • Clarify which steps are platform-specific and which are universal to avoid confusion.
  • Add explicit notes or callouts when a section is Windows-only or Linux-only.
  • Consider grouping platform-specific content under clear headings (e.g., 'Linux instructions', 'Windows instructions').
GitHub Create Pull Request
Aks Secure Pod Traffic with Network Policies in Azure Kubernetes Service (AKS) ...ks-docs/blob/main/articles/aks/use-network-policies.md
Low Priority View Details →
Scanned: 2026-02-04 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First 🔧 Windows Tools
Summary
The documentation provides both Linux and Windows examples for AKS network policy engines, but Windows-specific instructions (such as registering preview features and creating Windows admin credentials) are given in dedicated sections and sometimes appear before or alongside Linux instructions. The use of Azure CLI is platform-neutral, but Windows-specific tooling and steps (e.g., HNS ACLPolicy, Windows admin credential setup) are highlighted. The ordering of examples sometimes places Windows instructions before Linux equivalents, and Windows node pool requirements are called out in several places.
Recommendations
  • Ensure Linux instructions and examples are presented first or in parallel with Windows instructions, unless the feature is Windows-only.
  • Clearly separate platform-specific steps and label them as such to avoid confusion.
  • Where possible, provide explicit Linux/macOS equivalents for any Windows-specific commands or tooling.
  • Add clarifying notes when a step is only required for Windows node pools.
  • Consider grouping platform-specific instructions under clear subheadings for improved parity and discoverability.
GitHub Create Pull Request
Aks Create an internal load balancer ...s/azure-aks-docs/blob/main/articles/aks/internal-lb.md
Low Priority View Details →
Scanned: 2026-02-04 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
🔧 Windows Tools Windows First
Summary
The documentation provides both Azure CLI and PowerShell options for some prerequisite steps, but consistently lists PowerShell alongside CLI and links to PowerShell resources before Linux equivalents. In the 'Specify an IP address' section, both Azure CLI and PowerShell commands are referenced for subnet listing, but only the PowerShell cmdlet is named explicitly, while the CLI command is described generically. There are no Linux/macOS-specific examples or explicit mentions of Bash scripting, and PowerShell is referenced as a primary tool for Azure resource management. However, all core workflow examples (kubectl, YAML manifests, Azure CLI) are cross-platform.
Recommendations
  • When listing tools for prerequisites, mention Azure CLI first and clarify it is cross-platform, while PowerShell is Windows/macOS only.
  • For commands like subnet listing, provide explicit Bash/Azure CLI examples and clarify PowerShell is optional for Windows users.
  • Avoid linking to PowerShell documentation before CLI documentation unless the feature is Windows-only.
  • Add a note that all main steps (kubectl, Azure CLI) work on Linux/macOS, and PowerShell is optional.
  • Where PowerShell is referenced, provide equivalent Bash/CLI commands for Linux/macOS users.
GitHub Create Pull Request
← Previous Page 8 of 15 Next →