113
Total Pages
61
Linux-Friendly Pages
52
Pages with Bias
46.0%
Bias Rate

Bias Trend Over Time

Pages with Bias Issues

281 issues found
Showing 26-50 of 281 flagged pages
Expressroute Configure Azure ExpressRoute Direct ...cles/expressroute/how-to-expressroute-direct-portal.md
High Priority View Details →
Scanned: 2026-01-11 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 exhibits a Windows bias in several ways: PowerShell is presented as the primary or only scripting example in many sections, with explicit references to Windows file paths (e.g., C:\Users\SampleUser\Downloads) and Windows-centric instructions. Azure CLI examples are present, but PowerShell commands and terminology are often given first or exclusively, and Linux/macOS-specific details (such as file paths, shell usage, or troubleshooting) are missing. There are no explicit Linux shell examples, and the documentation assumes familiarity with Windows conventions.
Recommendations
  • Provide Linux/macOS-specific instructions and examples alongside Windows ones, especially for file paths and shell usage.
  • Ensure Azure CLI examples use POSIX-style paths (e.g., /home/username/Downloads/LOA.pdf) and clarify cross-platform compatibility.
  • Avoid referencing Windows-only locations (such as C:\Users\...) without also showing Linux/macOS equivalents.
  • Explicitly state that Azure CLI and Cloud Shell work on Linux/macOS and provide troubleshooting tips for those platforms.
  • Where PowerShell is used, clarify if PowerShell Core (cross-platform) is supported and provide bash/zsh alternatives where possible.
  • Review the ordering of examples so that Azure CLI (cross-platform) is presented before or alongside PowerShell, not after.
Expressroute Configure Connection Monitor for Azure ExpressRoute ...es/expressroute/how-to-configure-connection-monitor.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Powershell Heavy Windows First 🔧 Windows Tools Missing Linux Example
Summary
The documentation page demonstrates a bias toward Windows environments. PowerShell scripts are provided for key configuration steps (e.g., setting up the monitoring solution and firewall rules), with Linux instructions limited to manual file edits and lacking equivalent automation or scripting. Windows tools and patterns (Control Panel, PowerShell, registry keys) are mentioned first or exclusively, while Linux alternatives are less detailed and require more manual intervention. Linux users are expected to perform manual configuration steps without provided scripts or automation, and troubleshooting guidance is focused on Windows.
Recommendations
  • Provide equivalent Bash or shell scripts for Linux users to automate agent installation and firewall configuration, matching the PowerShell automation offered for Windows.
  • Present Linux and Windows instructions in parallel, giving equal prominence and detail to both platforms.
  • Include troubleshooting steps and verification guidance for Linux agents, not just Windows (e.g., checking service status, logs, connectivity).
  • Reference Linux tools and patterns (e.g., systemctl, iptables, ufw) alongside Windows tools, and avoid assuming Windows-first workflows.
  • Offer downloadable Linux scripts (e.g., .sh files) for common configuration tasks, similar to the provided PowerShell scripts.
  • Ensure all example commands and screenshots are available for both platforms, or clarify platform-specific differences.
Expressroute Reset a failed circuit - ExpressRoute | Microsoft Docs ...-docs/blob/main/articles/expressroute/reset-circuit.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example
Summary
The documentation provides detailed instructions for resetting an ExpressRoute circuit using the Azure portal and Azure PowerShell, both of which are most commonly used on Windows. There are no examples or guidance for Linux users, such as using Azure CLI or Bash, and the PowerShell instructions are presented before any mention of cross-platform alternatives.
Recommendations
  • Add equivalent instructions using Azure CLI, which is cross-platform and commonly used on Linux and macOS.
  • Include Bash shell examples for Linux users.
  • Explicitly state platform compatibility for each method (e.g., 'Azure PowerShell (Windows/macOS/Linux)', 'Azure CLI (Windows/macOS/Linux)').
  • Present cross-platform or Linux-friendly options before or alongside Windows-specific instructions to avoid implicit prioritization.
Expressroute Planned maintenance guidance for ExpressRoute ...blob/main/articles/expressroute/planned-maintenance.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy 🔧 Windows Tools Missing Linux Example
Summary
The documentation page demonstrates bias towards Windows environments by exclusively referencing PowerShell cmdlets (e.g., Get-AzExpressRouteCircuitStats) for monitoring and validation tasks, without providing equivalent Linux/CLI examples. There is no mention of Linux-native tools or cross-platform alternatives for ExpressRoute circuit monitoring, and all example commands assume a Windows/PowerShell context.
Recommendations
  • Include equivalent Azure CLI commands (az network express-route ...) for all PowerShell examples to ensure Linux and macOS users can follow along.
  • Mention and provide examples using standard Linux networking tools (e.g., tcpdump, netstat, bird, FRRouting) for BGP session monitoring and failover validation.
  • Clarify that Azure management tasks can be performed from any OS, and link to cross-platform documentation where available.
  • Ensure all monitoring and alerting instructions reference both PowerShell and Azure CLI, and avoid assuming a Windows-only environment.
Expressroute Using S2S VPN as a backup for Azure ExpressRoute Private Peering | Microsoft Docs ...ps://github.com/MicrosoftDocs/azure-docs/blob/main/articles/expressroute/use-s2s-vpn-as-backup-for-expressroute-privatepeering.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation page demonstrates a Windows bias by providing only Windows-based command examples (PowerShell, tracert from Windows shell), and omitting equivalent Linux commands (e.g., Bash, iproute2, traceroute, Azure CLI). All Azure management and route validation steps use PowerShell, with no mention of cross-platform alternatives. The failover testing section uses Windows tracert and PowerShell exclusively, with no Linux or macOS guidance.
Recommendations
  • Include Azure CLI examples alongside PowerShell for all Azure resource management tasks, as Azure CLI is cross-platform.
  • Provide Linux equivalents for network validation commands, such as using 'traceroute' instead of 'tracert', and show how to run these from a Linux VM or shell.
  • Add guidance for macOS users where relevant, especially for connectivity and troubleshooting steps.
  • Explicitly mention that both Windows and Linux can be used for on-premises test servers and provide sample commands for each.
  • Where possible, use generic commands (e.g., REST API, Azure Portal) or note platform-specific differences to ensure parity.
Expressroute Azure ExpressRoute: Configure S2S VPN over Microsoft peering ...xpressroute/site-to-site-vpn-over-microsoft-peering.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation page demonstrates a Windows bias by consistently providing Azure PowerShell examples for Azure-side configuration and validation, with no equivalent Azure CLI (cross-platform) or Linux-native commands. All Azure-side operational examples (viewing prefixes, checking tunnel status, verifying BGP, etc.) use PowerShell syntax, and instructions for finding public IPs mention PowerShell and the portal, but not Azure CLI. There are no Linux VPN device configuration examples; only Cisco IOS-XE is shown for on-premises, and the only VM reference is to Hyper-V (a Windows virtualization platform).
Recommendations
  • Add Azure CLI equivalents for all Azure PowerShell commands (e.g., Get-AzBgpServiceCommunity, Get-AzVirtualNetworkGatewayConnection, etc.), and present them alongside or before PowerShell examples.
  • Explicitly mention Linux support and provide examples for configuring common Linux-based VPN devices (e.g., strongSwan, libreswan) for IPsec/IKE and BGP.
  • Include instructions for finding public IP addresses and other resources using Azure CLI and Bash, not just PowerShell and the portal.
  • Reference Linux virtualization platforms (e.g., KVM, VMware) in addition to Hyper-V when discussing on-premises VPN device deployment.
  • Ensure that cross-platform tools and patterns are presented with parity and not subordinate to Windows/PowerShell approaches.
Expressroute Reset a failed circuit - ExpressRoute | Microsoft Docs ...-docs/blob/main/articles/expressroute/reset-circuit.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example
Summary
The documentation provides detailed instructions for resetting an ExpressRoute circuit using the Azure portal and Azure PowerShell, with all command-line examples exclusively using PowerShell. There are no examples or guidance for Linux users (e.g., Azure CLI or Bash), and the PowerShell workflow is presented as the only scripting option, implying a Windows-centric approach.
Recommendations
  • Add equivalent Azure CLI examples for Linux/macOS users alongside PowerShell instructions.
  • Explicitly mention that Azure CLI can be used on all platforms and provide links to installation/configuration guides.
  • Present command-line options in parallel (PowerShell and Azure CLI), rather than only PowerShell, to ensure platform neutrality.
  • Include notes or sections for Linux/macOS users to clarify cross-platform support.
Expressroute Configure customer-controlled maintenance for your virtual network gateway ...xpressroute/customer-controlled-gateway-maintenance.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example
Summary
The documentation page demonstrates a Windows bias by providing only Azure PowerShell examples for command-line configuration, with no mention of Linux-native tools or Azure CLI equivalents. The PowerShell steps are presented as the sole scripting option, and there are no Bash or Linux command-line instructions. This may disadvantage users who work primarily in Linux environments or prefer cross-platform tools.
Recommendations
  • Add Azure CLI examples alongside PowerShell for all command-line steps, as Azure CLI is cross-platform and widely used on Linux.
  • Explicitly mention that PowerShell can be used on Linux and macOS, or provide installation instructions for PowerShell on non-Windows platforms.
  • Include Bash script examples where appropriate, or clarify that the steps are platform-agnostic if true.
  • Reorder sections or add a note to indicate parity between Windows and Linux tooling, rather than implicitly prioritizing Windows/PowerShell.
Expressroute Azure ExpressRoute: Configure MACsec ...ain/articles/expressroute/expressroute-howto-macsec.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 First Missing Linux Example 🔧 Windows Tools
Summary
The documentation is heavily biased towards Windows and PowerShell usage. All configuration steps and code examples use Azure PowerShell cmdlets, with no mention of Linux shell equivalents, Azure CLI, or cross-platform tooling. Prerequisites and instructions assume the reader is using PowerShell, and there is no guidance for users on Linux or macOS platforms. No examples are provided for configuring MACsec using Bash, Azure CLI, or REST API, and there is no mention of Linux-specific considerations or tools.
Recommendations
  • Provide equivalent examples using Azure CLI (az) commands, which are cross-platform and widely used on Linux and macOS.
  • Include instructions and code snippets for Bash/shell environments, especially for steps like secret creation, identity assignment, and ExpressRoute port configuration.
  • Explicitly mention platform support and clarify that configuration can be performed from Linux/macOS as well as Windows.
  • Add a section or notes on how to install and use Azure CLI on Linux/macOS, and how to perform the same tasks without PowerShell.
  • Ensure that references to tools and modules (e.g., Az.ManagedServiceIdentity) include cross-platform alternatives.
  • Consider reordering or balancing examples so that Linux and Windows approaches are presented equally, or Linux-first where appropriate.
Expressroute Azure ExpressRoute: Prerequisites ...in/articles/expressroute/expressroute-prerequisites.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example
Summary
The documentation page demonstrates Windows bias by referencing Azure PowerShell commands as a prerequisite for ExpressRoute Direct enrollment, without mentioning Azure CLI or Linux/macOS alternatives. There are no examples or instructions for Linux users, and the only tooling mentioned is PowerShell, which is traditionally associated with Windows environments.
Recommendations
  • Include Azure CLI commands alongside PowerShell instructions for all steps, especially prerequisites and enrollment.
  • Explicitly mention cross-platform support for Azure management tools (e.g., Azure CLI works on Linux, macOS, and Windows).
  • Add examples or guidance for Linux/macOS users, such as shell commands or links to relevant documentation.
  • Avoid assuming PowerShell as the default tool; present both PowerShell and CLI options in parallel.
  • Where possible, clarify that ExpressRoute setup can be performed from any supported OS, not just Windows.
Expressroute Configure custom alerts to monitor advertised routes - Azure ExpressRoute ...ain/articles/expressroute/how-to-custom-route-alert.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example
Summary
The documentation is heavily focused on PowerShell, with all automation and scripting examples provided exclusively in PowerShell. There are no references to Linux-native tools, Bash, or cross-platform alternatives. The requirement to use Azure PowerShell is stated upfront, and no mention is made of using Azure CLI or other scripting environments that are more common on Linux. The workflow and examples implicitly assume a Windows-centric approach, which may exclude or inconvenience Linux users.
Recommendations
  • Provide equivalent examples using Azure CLI (az commands), which is cross-platform and widely used on Linux.
  • Explicitly mention that Azure Automation supports Python runbooks and provide a sample Python script for the same workflow.
  • Clarify which steps are platform-agnostic (e.g., Logic Apps configuration) and which are specific to Windows/PowerShell.
  • Add a section or callout for Linux users, outlining how to achieve the same monitoring and alerting using Bash scripts or other Linux-friendly tools.
  • Where PowerShell is required, note that PowerShell Core is available on Linux and macOS, and provide guidance for installation and usage on those platforms.
Expressroute Azure ExpressRoute FastPath: Features, availability, and limitations ...docs/blob/main/articles/expressroute/about-fastpath.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example
Summary
The documentation page demonstrates a Windows bias by providing configuration instructions specifically for Azure PowerShell, which is traditionally Windows-centric, and by omitting equivalent Linux/CLI examples. The 'Next steps' section lists PowerShell before any cross-platform alternatives and does not mention Azure CLI or other Linux-friendly tools, making it less accessible for Linux users.
Recommendations
  • Add configuration instructions using Azure CLI, which is cross-platform and widely used on Linux.
  • Present Azure CLI and PowerShell examples side by side, or list CLI first to avoid Windows-first ordering.
  • Explicitly mention that all configuration steps can be performed on Linux, macOS, and Windows, and provide links to platform-specific guidance where relevant.
  • Review the documentation for any other tool references (e.g., scripts, troubleshooting steps) and ensure Linux equivalents are provided.
Expressroute About ExpressRoute virtual network gateways ...ssroute/expressroute-about-virtual-network-gateways.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Powershell Heavy Missing Linux Example 🔧 Windows Tools Windows First
Summary
The documentation page exhibits a Windows bias by providing only Azure PowerShell examples for gateway subnet creation, referencing PowerShell and REST APIs as the primary configuration tools, and omitting equivalent Azure CLI (cross-platform) or Linux-native command examples. PowerShell is mentioned before CLI in several places, and there are no bash or Linux-specific instructions or screenshots. This may disadvantage users working on Linux or macOS platforms.
Recommendations
  • Add Azure CLI examples alongside PowerShell for all configuration steps, especially for gateway subnet creation.
  • Explicitly mention cross-platform tools (Azure CLI, bash) and provide usage instructions for Linux/macOS environments.
  • Ensure screenshots and walkthroughs are not Windows-centric; include examples from Linux terminals where appropriate.
  • List Azure CLI before or alongside PowerShell when referencing configuration tools to avoid 'windows_first' ordering.
  • Include notes or links to Linux-specific documentation for ExpressRoute gateway management.
Expressroute About Azure ExpressRoute Direct ...n/articles/expressroute/expressroute-erdirect-about.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Missing Linux Example 🔧 Windows Tools
Summary
The documentation page demonstrates Windows bias by exclusively providing Azure PowerShell commands for onboarding, without mentioning or providing equivalent instructions for Linux users (e.g., Azure CLI or Bash). The onboarding workflow assumes the use of PowerShell, which is traditionally a Windows tool, and does not offer parity for Linux or cross-platform environments.
Recommendations
  • Add Azure CLI (az) command examples alongside PowerShell for all onboarding and management steps.
  • Explicitly mention that Azure CLI is available on Linux, macOS, and Windows, and provide installation links.
  • Where PowerShell is referenced, clarify cross-platform support or provide Bash alternatives for Linux users.
  • Review all workflows and ensure that instructions are not Windows-centric, and that Linux users can follow with equivalent tooling.
  • Include notes or tables comparing PowerShell and CLI commands for common tasks.
Expressroute ExpressRoute for Cloud Solution Providers - Azure | Microsoft Docs ...ressroute/expressroute-for-cloud-solution-providers.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 First Missing Linux Example 🔧 Windows Tools
Summary
The documentation page exhibits Windows bias in several ways: it references PowerShell for ExpressRoute routing configuration without mentioning Linux equivalents (such as Azure CLI or REST API), links to Windows-specific management APIs, and omits Linux-based or cross-platform tooling in configuration and management examples. There are no explicit Linux or cross-platform command-line examples, and Windows tools/patterns are mentioned exclusively or first.
Recommendations
  • Include Azure CLI and/or REST API examples alongside PowerShell for ExpressRoute configuration and management tasks.
  • Reference cross-platform management tools and documentation, not just Windows-specific APIs.
  • Add explicit Linux-based workflow examples for ExpressRoute provisioning, routing, and security configuration.
  • Ensure links to management capabilities and tutorials cover both Windows and Linux environments.
  • Review and update diagrams or figures to avoid implicit Windows-centric assumptions (e.g., showing only Windows servers or tools).
Expressroute Azure ExpressRoute: Add IPv6 support for private peering ...n/articles/expressroute/expressroute-howto-add-ipv6.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy 🔧 Windows Tools
Summary
The documentation demonstrates a moderate Windows bias. PowerShell examples and references are prominent and sometimes prioritized, with explicit instructions to use PowerShell for steps where the portal experience is incomplete. Windows-centric tools (PowerShell) are referenced frequently, and in some cases, the portal and PowerShell instructions are given before CLI (Linux-friendly) equivalents. There are no Linux-specific shell or scripting examples, and the CLI instructions are sometimes less detailed than PowerShell ones.
Recommendations
  • Ensure Azure CLI instructions are as detailed and complete as PowerShell examples, especially for advanced scenarios.
  • Where the portal experience is incomplete, provide equivalent CLI instructions alongside PowerShell, rather than instructing users to use PowerShell only.
  • Add explicit notes or examples for Linux/macOS users, such as Bash scripting or Cloud Shell usage from non-Windows environments.
  • Avoid language that assumes PowerShell is the default or preferred automation tool; present CLI and PowerShell as equal options.
  • Where possible, provide troubleshooting and verification steps using both CLI and PowerShell.
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example
Summary
The documentation page demonstrates a bias toward Windows by exclusively providing Azure PowerShell examples and instructions, which are most commonly used on Windows. There are no equivalent examples using Azure CLI or Bash, which are preferred on Linux and macOS. The workflow and step-by-step guidance assume use of PowerShell, and Linux-friendly alternatives are only mentioned in passing, without concrete examples.
Recommendations
  • Add step-by-step instructions and code samples using Azure CLI for all major operations (creating, provisioning, and deleting ExpressRoute circuits).
  • Include Bash shell examples for template deployment, especially for users on Linux/macOS.
  • Present both PowerShell and CLI/Bash examples side-by-side or in parallel sections to ensure parity.
  • Clarify that Azure PowerShell is cross-platform, but also highlight and demonstrate CLI usage for Linux users.
  • Avoid language that assumes the user is on Windows (e.g., 'Right-click the shell console'), and provide platform-neutral instructions.
Expressroute FAQ - Azure ExpressRoute | Microsoft Docs ...s/blob/main/articles/expressroute/expressroute-faqs.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
🔧 Windows Tools Powershell Heavy Windows First Missing Linux Example
Summary
The documentation page for Azure ExpressRoute FAQ demonstrates a Windows bias in several areas. PowerShell is frequently referenced as a primary tool for configuration and management tasks, with no equivalent Bash, Linux CLI, or cross-platform examples provided. Instructions for tasks such as enabling/disabling ExpressRoute premium, configuring route filters, and modifying circuit bandwidth mention PowerShell and REST API, but do not offer Linux-specific CLI or Bash alternatives. The documentation refers to Windows-centric tools and patterns (e.g., PowerShell cmdlets) before mentioning Azure CLI, and sometimes omits Azure CLI or Linux shell examples entirely. There is no mention of Linux networking tools, nor are there examples or guidance for users operating from Linux environments.
Recommendations
  • Provide Azure CLI (az) command examples alongside or before PowerShell for all configuration and management tasks.
  • Include Bash shell script snippets for common operations, especially those relevant to Linux administrators.
  • Ensure REST API references are accompanied by cross-platform usage examples (e.g., curl commands).
  • Explicitly mention that all operations can be performed from Linux/macOS environments, and link to relevant cross-platform tool documentation.
  • Avoid listing Windows/PowerShell instructions first; alternate or combine with Linux/Azure CLI instructions.
  • Add troubleshooting and operational guidance using Linux-native networking tools (e.g., ip, netstat, tcpdump) where relevant.
Expressroute Configure a virtual network gateway for ExpressRoute using the Azure portal ...expressroute-howto-add-gateway-portal-resource-manager.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation page demonstrates Windows bias by prioritizing Azure portal and PowerShell instructions, with explicit references to PowerShell for advanced configuration (e.g., IPv6-based private peering). There are no CLI (az) or Linux/macOS-specific examples, and the only command-line automation referenced is PowerShell, which is primarily a Windows tool. The navigation selector and important notes direct users to PowerShell-based instructions, with no mention of Bash, Azure CLI, or cross-platform alternatives.
Recommendations
  • Add equivalent Azure CLI (az) instructions for all PowerShell-based steps, especially for advanced scenarios like IPv6-based private peering.
  • Update navigation selectors to include 'Resource Manager - Azure CLI' alongside PowerShell and portal options.
  • Ensure all command-line examples are provided for both PowerShell and Azure CLI, with clear indications of platform compatibility.
  • Where screenshots or UI steps are given, provide CLI alternatives for users who prefer automation or are on Linux/macOS.
  • Explicitly mention cross-platform support and link to documentation for Linux/macOS users where relevant.
Expressroute Configure ExpressRoute and S2S VPN coexisting connections: classic ...les/expressroute/expressroute-howto-coexist-classic.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Powershell Heavy Missing Linux Example 🔧 Windows Tools Windows First
Summary
The documentation is heavily biased towards Windows, with all configuration steps and code samples using Azure PowerShell cmdlets, which are primarily Windows-centric. There are no examples or instructions for Linux users (e.g., using Azure CLI, Bash, or cross-platform tools). The installation instructions and workflow assume a Windows environment (e.g., referencing C:\ paths and PowerShell), and there is no mention of Linux equivalents or alternatives. The structure and flow of the documentation present Windows/PowerShell as the default and only supported method.
Recommendations
  • Add equivalent Azure CLI (az) commands for all configuration steps, ensuring Linux and macOS users can follow along.
  • Include instructions for installing and using Azure CLI on Linux and macOS, alongside PowerShell.
  • Replace or supplement Windows file paths (e.g., 'C:\NetworkConfig.xml') with Linux/macOS examples (e.g., '/home/user/NetworkConfig.xml').
  • Explicitly state cross-platform support and provide guidance for users on non-Windows systems.
  • Where PowerShell is required (e.g., for classic model), clarify if PowerShell Core (cross-platform) is supported, and provide installation steps for Linux/macOS if applicable.
  • Consider adding a section or callout for Linux-specific VPN device configuration and troubleshooting.
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation page demonstrates a Windows bias by listing 'PowerShell' examples and links before 'Azure CLI', and by referencing PowerShell (including a 'PowerShell (classic)' link) as a primary automation method. There are no explicit Linux-specific instructions, nor are Linux tools or shell commands mentioned. The examples and walkthroughs focus exclusively on the Azure portal UI, with automation options presented in a Windows-centric order and terminology. Linux users are not provided with parity in terms of example commands or tool references.
Recommendations
  • Ensure that Azure CLI examples are presented alongside or before PowerShell examples, as Azure CLI is cross-platform and widely used on Linux.
  • Include explicit Linux shell (bash) command examples for common tasks, such as linking a VNet to an ExpressRoute circuit.
  • Reference Linux-native tools and workflows where applicable, such as using Azure CLI in bash scripts.
  • Clarify that all automation steps can be performed on Linux, macOS, and Windows, and avoid implying PowerShell is the default or preferred method.
  • Add a section or note for Linux users, describing any platform-specific considerations or best practices.
Expressroute Azure ExpressRoute: Configure Global Reach ...es/expressroute/expressroute-howto-set-global-reach.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Missing Linux Example 🔧 Windows Tools
Summary
The documentation is heavily biased toward Windows by exclusively using Azure PowerShell cmdlets for all configuration steps. There are no examples or instructions for using Azure CLI, REST API, or other cross-platform tools, which are commonly used on Linux and macOS. The prerequisites and guidance assume the use of PowerShell, and there is no mention of Bash, shell scripting, or Linux-native workflows.
Recommendations
  • Provide equivalent Azure CLI examples for each PowerShell command, as Azure CLI is cross-platform and widely used on Linux and macOS.
  • Include a section or callouts for REST API or ARM template usage for users who prefer automation or non-interactive configuration.
  • Explicitly mention that all steps can be performed from any OS using Azure CLI or Cloud Shell, not just PowerShell.
  • Add notes or links to documentation on installing and using Azure CLI on Linux.
  • Ensure that any references to local tool installation (e.g., PowerShell) are paired with Linux/macOS alternatives or instructions.
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 is heavily biased toward Windows environments. All command-line examples use Azure PowerShell, which is primarily used on Windows. There are no CLI or Bash examples for Linux/macOS users. The only traffic testing tool mentioned is PsPing, a Windows-only Sysinternals utility, with no mention of cross-platform alternatives. Windows-centric tools and patterns are referenced exclusively and before any Linux equivalents (which are absent).
Recommendations
  • Add Azure CLI examples alongside or before PowerShell examples for all resource queries and configuration steps. Azure CLI is cross-platform and widely used on Linux/macOS.
  • Include Bash or shell script equivalents for command-line operations, especially for resource listing and querying.
  • Mention and provide examples for cross-platform network testing tools such as 'ping', 'hping', or 'nping' instead of or in addition to PsPing.
  • Explicitly state which steps and tools are applicable to Linux/macOS and provide guidance for those platforms.
  • Where PowerShell is used, note that it can be installed on Linux/macOS, but also provide native alternatives.
  • Review and update troubleshooting steps to ensure parity for Linux-based environments, including ARP and route table inspection commands.
Expressroute Azure ExpressRoute: Circuit configuration workflow ...b/main/articles/expressroute/expressroute-workflows.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation references PowerShell and the Azure portal as primary verification and configuration tools, with no mention of Linux-specific tools or command-line examples (such as Azure CLI on Linux, Bash, or cross-platform instructions). The workflow implicitly assumes Windows environments by listing PowerShell before CLI and omitting Linux/Bash guidance, which may disadvantage Linux users.
Recommendations
  • Provide Azure CLI examples alongside or before PowerShell examples, especially for verification and provisioning steps.
  • Explicitly mention that Azure CLI is cross-platform and suitable for Linux and macOS users.
  • Include Bash script snippets or instructions for common configuration tasks.
  • Add a section or callout for Linux users, highlighting any platform-specific considerations or best practices.
  • Ensure all tool references (e.g., monitoring, provisioning) include both portal, PowerShell, and CLI options with equal prominence.
Expressroute Azure ExpressRoute: ARP tables - Troubleshooting ...e/expressroute-troubleshooting-arp-resource-manager.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example
Summary
The documentation page exclusively provides PowerShell-based instructions and examples for obtaining ARP tables on Azure ExpressRoute circuits. There are no references to Linux tools, Bash, Azure CLI, or cross-platform alternatives. The prerequisites and all troubleshooting steps assume the use of PowerShell, which is traditionally associated with Windows environments, and do not mention how Linux or macOS users can perform equivalent operations.
Recommendations
  • Add equivalent instructions and examples using Azure CLI, which is cross-platform and commonly used on Linux and macOS.
  • Include sample Bash commands or scripts for retrieving ARP tables, if possible.
  • Explicitly mention platform compatibility for each method (e.g., 'This PowerShell method works on Windows and on Linux/macOS with PowerShell Core').
  • Provide guidance for installing and using PowerShell Core on Linux/macOS, if PowerShell is required.
  • Consider restructuring the page to present cross-platform methods first, or side-by-side with Windows/PowerShell methods, to avoid Windows-first bias.