27
Total Pages
14
Linux-Friendly Pages
13
Pages with Bias
48.1%
Bias Rate

Bias Trend Over Time

Pages with Bias Issues (22)

Page-Level Analysis

Windows First Missing Linux Example
Summary:
The tutorial demonstrates a Windows bias by exclusively deploying and testing with Windows Server virtual machines and using Remote Desktop Protocol (RDP) and Internet Explorer for validation. There are no examples or instructions for deploying Linux servers, using SSH, or testing with Linux-native tools. All server deployment and connectivity testing steps assume a Windows environment.
Recommendations:
  • Include parallel instructions for deploying Linux virtual machines (e.g., Ubuntu Server) alongside Windows Server.
  • Provide examples for connecting to Linux VMs using SSH, and for testing firewall rules with Linux-native tools (e.g., curl, wget, or a Linux browser).
  • Demonstrate how to test application and network rules from a Linux VM, such as using SSH to connect between VMs or using command-line tools to access allowed/blocked FQDNs.
  • Mention both RDP (for Windows) and SSH (for Linux) in firewall rule creation and testing sections.
  • Use neutral language when referring to operating systems, and avoid assuming the user will always deploy Windows workloads.

Page-Level Analysis

Powershell Heavy Missing Linux Example Windows Tools
Summary:
The documentation provides only a PowerShell example (Remove-AzResourceGroup) for cleaning up resources, with no equivalent command for Linux users (such as Azure CLI or Bash). Additionally, the firewall policy example specifically references Windows Update using the WindowsUpdate FQDN tag, and there are no Linux-specific or cross-platform examples or guidance provided.
Recommendations:
  • Include Azure CLI (az group delete) and/or Bash examples alongside PowerShell for resource cleanup, to support Linux and macOS users.
  • When referencing firewall rules, provide examples for both Windows-specific (e.g., Windows Update) and common Linux update endpoints (e.g., Ubuntu, Red Hat repositories) to ensure parity.
  • Review all command-line instructions and ensure both Windows (PowerShell) and Linux (CLI/Bash) equivalents are presented.
  • Consider adding a note or section on how to perform all steps using cross-platform tools, not just those available on Windows.

Page-Level Analysis

Powershell Heavy Windows First Missing Linux Example
Summary:
The documentation provides configuration examples only for the Azure Portal, Azure CLI, and Azure PowerShell. While Azure CLI is cross-platform, the PowerShell examples are Windows-centric, and there are no explicit Linux shell (bash) or automation examples. The PowerShell tab is always present, and the documentation metadata includes 'devx-track-azurepowershell', suggesting a Windows/PowerShell bias. There are no Linux-specific instructions or references to Linux-native tools or scripting, and no mention of Linux-specific considerations for DNS or network configuration.
Recommendations:
  • Add explicit bash/shell script examples for Linux users alongside PowerShell, especially for scripting and automation tasks.
  • Clarify that Azure CLI commands are cross-platform and provide any Linux-specific notes if needed (e.g., differences in environment variables, quoting, or file paths).
  • Include troubleshooting or configuration notes relevant to Linux VMs (e.g., how to update /etc/resolv.conf or use cloud-init for DNS settings).
  • Balance the prominence of PowerShell and CLI examples, and consider renaming tabs to 'Shell (Linux/macOS)' and 'PowerShell (Windows)' for clarity.
  • Review metadata and custom tags to ensure they do not signal a Windows/PowerShell preference unless justified.

Page-Level Analysis

Windows First Missing Linux Example Windows Tools
Summary:
The documentation demonstrates a Windows bias by exclusively deploying Windows Server 2019 virtual machines for testing, instructing users to use Remote Desktop and Internet Explorer (both Windows-specific tools), and omitting any Linux VM deployment or Linux-based testing workflow. While the deployment and validation steps use both Azure CLI and PowerShell (which are cross-platform), all VM interaction and firewall testing instructions assume a Windows environment.
Recommendations:
  • Include Linux virtual machine deployment in the Bicep template and documentation, or provide an alternative Linux-based workflow.
  • Add instructions for connecting to Linux VMs (e.g., using SSH) and testing firewall rules with Linux tools (such as curl or wget) instead of only using Remote Desktop and Internet Explorer.
  • Present both Windows and Linux examples side-by-side when describing how to test connectivity and firewall rules.
  • Avoid referencing Windows-specific tools (like Internet Explorer) as the only method for testing, or provide Linux browser/command-line alternatives.
  • Clarify that the scenario can be tested with either Windows or Linux VMs, and provide guidance for both.

Page-Level Analysis

Missing Linux Example
Summary:
The documentation exclusively uses the Azure Portal (GUI) for configuration steps and does not provide any command-line examples for either Windows (PowerShell) or Linux (CLI). However, the absence of Azure CLI (cross-platform, Linux-friendly) examples means Linux users do not have parity with Windows users who might be more accustomed to GUI or PowerShell workflows.
Recommendations:
  • Add Azure CLI examples for each configuration step to ensure Linux and cross-platform users can follow along without relying on the portal.
  • Explicitly mention that all steps can be performed using Azure CLI or ARM templates, and provide links or code snippets.
  • If PowerShell examples are added in the future, ensure Azure CLI equivalents are also provided and presented with equal prominence.

Page-Level Analysis

Windows First Missing Linux Example
Summary:
The documentation exclusively references Windows Server 2019 virtual machines for testing the firewall and does not mention or provide examples for Linux-based virtual machines. There are no instructions or guidance for deploying or testing with Linux VMs, nor are Linux tools or patterns discussed.
Recommendations:
  • Include parallel instructions and Terraform resource examples for deploying Linux virtual machines (e.g., using azurerm_linux_virtual_machine).
  • Describe how to test firewall rules from a Linux VM, including example commands (e.g., using curl or wget to access www.microsoft.com).
  • Explicitly mention that either Windows or Linux VMs can be used for testing, and provide guidance for both.
  • Ensure that troubleshooting and cleanup steps are applicable to both Windows and Linux environments, or note any differences.

Page-Level Analysis

Windows First Windows Tools
Summary:
The documentation page demonstrates subtle Windows bias by listing Azure PowerShell (a Windows-centric tool) before CLI in several places and referencing PowerShell explicitly as a supported deployment mechanism. There is no explicit Linux example or mention of Linux-specific tools, and the migration example only references the portal and Azure PowerShell, omitting CLI or Linux-native approaches.
Recommendations:
  • Ensure that Azure CLI is always mentioned alongside or before Azure PowerShell, as CLI is cross-platform and widely used on Linux.
  • When referencing deployment mechanisms, clarify that both Azure CLI and PowerShell are supported, and provide parity in examples and migration paths.
  • Add explicit examples or references for Linux users, such as using Azure CLI for policy creation, management, and migration.
  • Avoid listing Windows tools (like PowerShell) before cross-platform tools (like CLI) to prevent the perception of Windows-first bias.
  • Consider including a table or section that highlights tool parity and usage across different operating systems.

Page-Level Analysis

Missing Linux Example Windows Tools
Summary:
The documentation page does not provide any OS-specific examples, but it references protocols and tools (such as RDP) that are strongly associated with Windows environments. There are no Linux-specific examples or tools mentioned, and the documentation does not demonstrate parity in terms of cross-platform usage or guidance.
Recommendations:
  • Include examples or references to Linux-relevant protocols and tools (e.g., SSH, SCP, SFTP) alongside or before Windows-centric ones like RDP.
  • Explicitly mention that FQDN filtering applies equally to Linux and Windows environments.
  • Provide example scenarios or command-line snippets for both Windows (PowerShell) and Linux (Bash/CLI) where relevant.
  • Balance protocol mentions so that Linux use cases are as visible as Windows ones.

Page-Level Analysis

Powershell Heavy Windows Tools Windows First
Summary:
The documentation page lists Azure PowerShell cmdlets prominently in a dedicated section, without providing equivalent Azure CLI or REST API examples or references. This creates a bias towards Windows/PowerShell users, as PowerShell is most commonly associated with Windows environments. While the text mentions that IP Groups can be managed via the Azure portal, Azure CLI, or REST API, only PowerShell commands are explicitly documented, and no Linux-friendly command-line examples are provided.
Recommendations:
  • Add a dedicated section listing equivalent Azure CLI commands for managing IP Groups, similar to the PowerShell cmdlets section.
  • Provide REST API example calls for creating, updating, and deleting IP Groups.
  • Ensure that CLI and REST API references are as detailed and prominent as the PowerShell section.
  • Where possible, present CLI examples before or alongside PowerShell examples to avoid Windows-first ordering.
  • Clarify that Azure CLI is cross-platform and can be used on Linux, macOS, and Windows.

Page-Level Analysis

Windows First Missing Linux Example Windows Tools Powershell Heavy
Summary:
The documentation demonstrates a clear Windows bias: it only deploys Windows Server VMs for testing, instructs users to use Remote Desktop and Internet Explorer, and provides only PowerShell (Windows-centric) commands for resource cleanup. There are no Linux VM deployment or validation instructions, nor are Linux tools or command-line examples mentioned.
Recommendations:
  • Include Linux VM deployment in the ARM template or as an alternative option, and provide instructions for connecting to Linux VMs (e.g., using SSH).
  • Add validation steps for Linux, such as using curl or a browser on a Linux VM to test firewall rules.
  • Provide Azure CLI or Bash commands for resource cleanup, not just PowerShell.
  • Mention cross-platform tools and browsers (e.g., Edge, Chrome, Firefox) instead of only Internet Explorer.
  • Present both Windows and Linux examples side-by-side where relevant, or clarify that the steps are specific to Windows and link to Linux equivalents.

Page-Level Analysis

Windows First Missing Linux Example
Summary:
The tutorial exclusively uses Windows Server virtual machines and only demonstrates remote desktop (RDP) and Internet Explorer for connectivity and testing. There are no Linux VM deployment steps, nor are there examples for SSH access or Linux-based testing. The documentation assumes a Windows-centric workflow throughout, omitting Linux alternatives.
Recommendations:
  • Include parallel instructions for deploying a Linux VM (e.g., Ubuntu) alongside the Windows VM steps.
  • Provide examples for connecting to Linux VMs using SSH, and for testing firewall rules with Linux tools (e.g., curl, wget, or a browser like Firefox).
  • When demonstrating firewall rules, show both RDP (for Windows) and SSH (for Linux) DNAT/network rules.
  • In testing sections, include Linux-based connectivity tests (e.g., SSH from one Linux VM to another, or browsing with a Linux browser).
  • Use neutral language and ordering (e.g., 'Windows or Linux VM') to avoid implying Windows is the default or only supported platform.

Page-Level Analysis

Powershell Heavy Windows Tools Missing Linux Example Windows First
Summary:
The documentation page demonstrates a strong Windows bias by exclusively using Azure PowerShell (Windows-centric) command-line examples and referencing Windows file paths (e.g., C:\CustomRoles\...). There are no examples or instructions for Linux users (e.g., using Azure CLI or Bash), and the documentation does not mention Linux tools or provide cross-platform guidance. The ordering and content assume a Windows environment by default.
Recommendations:
  • Provide equivalent Azure CLI (az) command examples for all PowerShell commands, as Azure CLI is cross-platform and widely used on Linux and macOS.
  • Use platform-neutral file paths in examples (e.g., ~/CustomRoles/ or /home/user/CustomRoles/ for Linux/macOS) or explicitly show both Windows and Linux paths.
  • Add a section or callouts indicating that all steps can be performed on Linux/macOS, and provide any necessary differences or prerequisites.
  • Reference both PowerShell and Bash (or shell) scripting where automation is discussed, or provide links to relevant cross-platform scripting documentation.
  • Consider reordering or parallelizing example blocks so that Linux and Windows users see their options side by side, rather than Windows-first.

Page-Level Analysis

Windows First Missing Linux Example Windows Tools Powershell Heavy
Summary:
The documentation demonstrates a Windows bias by exclusively deploying Windows Server virtual machines for testing, instructing users to use Remote Desktop and Internet Explorer (both Windows-specific), and providing only PowerShell (Remove-AzResourceGroup) for resource cleanup. There are no Linux VM deployment options, no SSH or Linux-based validation steps, and no CLI/Bash examples for resource management.
Recommendations:
  • Include Linux virtual machine deployment options in the ARM template and documentation steps.
  • Provide validation instructions for Linux VMs (e.g., using SSH to connect, using curl or a browser to test connectivity).
  • Offer Azure CLI or Bash examples for resource cleanup alongside PowerShell commands.
  • Mention both RDP (for Windows) and SSH (for Linux) as connection methods.
  • Avoid referencing Windows-only tools (like Internet Explorer) as the sole example; suggest cross-platform browsers or command-line tools.

Page-Level Analysis

Windows First Missing Linux Example
Summary:
The documentation exclusively references Windows Server 2019 virtual machines for testing the firewall and does not mention or provide examples for Linux-based virtual machines. There are no Linux equivalents or instructions, and the only OS context given is Windows, which may lead users to believe that Linux is unsupported or less suitable for this scenario.
Recommendations:
  • Include examples and instructions for deploying and testing with Linux virtual machines (e.g., Ubuntu, CentOS) alongside or instead of Windows VMs.
  • Explicitly mention that the scenario works with both Windows and Linux VMs, and provide sample Terraform code for azurerm_linux_virtual_machine.
  • If remote connectivity or testing steps are described (e.g., using RDP for Windows), also describe SSH access for Linux VMs.
  • Ensure that any firewall rule testing steps include Linux command-line examples (e.g., using curl or wget) in addition to Windows-based methods.
  • Review the documentation for any other implicit Windows assumptions and clarify cross-platform compatibility where applicable.

Page-Level Analysis

Windows First Missing Linux Example Powershell Heavy Windows Tools
Summary:
The documentation exhibits a strong Windows bias. All virtual machine examples use Windows Server 2019 Datacenter, and the only automation example for configuring IIS uses Azure PowerShell with Windows-specific commands. There are no Linux VM deployment or configuration examples, nor any mention of Linux tools or shell commands. The test and usage scenarios (RDP, PowerShell, IIS) are all Windows-centric, with no Linux alternatives provided.
Recommendations:
  • Provide parallel Linux examples for VM creation, such as deploying Ubuntu or other Linux distributions.
  • Include automation examples using Bash/Cloud Shell for Linux VMs (e.g., using Azure CLI and cloud-init for installing Apache or Nginx).
  • Demonstrate connectivity tests using SSH and curl/wget from a Linux VM, in addition to RDP and browser tests.
  • Mention both Windows and Linux options when describing VM creation steps and testing scenarios.
  • When showing PowerShell scripts, also provide equivalent Azure CLI/Bash scripts for Linux users.

Page-Level Analysis

Missing Linux Example
Summary:
The documentation exclusively describes how to configure Azure DDoS Protection Plan using the Azure Portal GUI, with no command-line examples provided for any platform. There are no references to Windows-specific tools or PowerShell, but there is also a complete absence of CLI instructions (such as Azure CLI or Bash), which are commonly used on Linux and cross-platform environments. This omission may disadvantage Linux users or those who prefer automation and scripting.
Recommendations:
  • Add Azure CLI examples for each step, showing how to create firewall policies, secured virtual networks, DDoS Protection Plans, and associations via command line.
  • Ensure that any scripting examples are cross-platform (e.g., Bash/Azure CLI rather than PowerShell-only).
  • Include a section comparing portal, PowerShell, and Azure CLI approaches, with links to relevant documentation for each.
  • Explicitly mention that all steps can be performed via Azure CLI and provide links or code snippets for Linux/macOS users.

Page-Level Analysis

Powershell Heavy Windows First
Summary:
The documentation provides both Azure CLI and PowerShell examples for configuring Azure Firewall DNS settings, but the PowerShell examples are prominent and detailed, reflecting a bias toward Windows-centric tooling. There are no Linux-specific command-line examples (such as Bash scripts or Linux-native tools), and PowerShell is presented as an equal alternative to CLI, despite being primarily a Windows tool. The documentation does not mention or address Linux-specific considerations or workflows, and the ordering of examples sometimes places PowerShell before or at parity with CLI, which may not reflect the cross-platform user base.
Recommendations:
  • Add explicit Bash shell examples for all CLI commands, demonstrating usage in a typical Linux environment.
  • Clarify that Azure CLI is cross-platform and can be used on Windows, macOS, and Linux, while PowerShell is primarily for Windows users (unless using PowerShell Core).
  • Consider providing Linux-specific notes or troubleshooting tips, such as how to restart network services on Linux VMs after DNS changes.
  • Where possible, lead with CLI/Bash examples before PowerShell, as CLI is more universally accessible across platforms.
  • Include references or links to Linux administration documentation for related tasks (e.g., updating DNS settings on Linux VMs).

Page-Level Analysis

Powershell Heavy Windows Tools Windows First
Summary:
The documentation page demonstrates a Windows bias by prominently featuring Azure PowerShell cmdlets as the only explicit command-line tooling for managing IP Groups. While it mentions the Azure portal, Azure CLI, and REST API as options, it provides detailed links and examples only for PowerShell, which is primarily associated with Windows environments. There are no Azure CLI (cross-platform) or REST API command examples or references, and no Linux-specific guidance is provided.
Recommendations:
  • Add equivalent Azure CLI commands and documentation links for all PowerShell cmdlets listed, ensuring Linux and macOS users have clear, first-class instructions.
  • Include REST API examples or references alongside PowerShell and CLI, to support automation and cross-platform use.
  • When listing tools or commands, present Azure CLI and REST API options before or alongside PowerShell to avoid implying Windows-first workflows.
  • Explicitly state that all management operations can be performed from Linux, macOS, and Windows, and provide examples for each where relevant.

Page-Level Analysis

Windows First Powershell Heavy Missing Linux Example
Summary:
The documentation page exhibits a subtle Windows bias by consistently listing Azure PowerShell before CLI in supported mechanisms, mentioning PowerShell specifically for migration and classic rules, and omitting explicit Linux or Bash examples or tools. There are no Linux-specific instructions or parity in example commands, and the documentation assumes familiarity with PowerShell, which is more common on Windows.
Recommendations:
  • Ensure that Azure CLI (which is cross-platform) is listed before or alongside PowerShell in all supported mechanisms and migration instructions.
  • Provide explicit Bash/Linux shell examples or references where PowerShell is mentioned.
  • Include notes or links for Linux/macOS users, especially in sections discussing migration or management via command line.
  • Avoid assuming PowerShell as the default scripting environment; clarify that both PowerShell and CLI are supported equally.
  • Where possible, add sample commands for both PowerShell and Bash/CLI to demonstrate parity.

Page-Level Analysis

Linux Example Present Windows Missing No Os Bias
Summary:
The documentation does not exhibit Windows bias. In fact, the only explicit OS-specific example is for Linux (using dig for DNS queries). There are no PowerShell or Windows command-line examples, nor are Windows tools or patterns mentioned exclusively or preferentially. All Azure CLI examples are cross-platform. No Windows-specific instructions or screenshots are present.
Recommendations:
  • Maintain parity by continuing to provide cross-platform (Azure CLI) examples.
  • Optionally, add Windows (e.g., nslookup) and macOS (e.g., dig) equivalents alongside the Linux dig example for DNS troubleshooting to further enhance inclusivity.
  • Continue to avoid OS-specific bias by not assuming a particular client OS in future documentation updates.

Page-Level Analysis

Powershell Heavy Missing Linux Example Windows Tools
Summary:
The documentation provides only a PowerShell example (Remove-AzResourceGroup) for resource cleanup, with no equivalent CLI or Bash example. Additionally, the firewall policy example specifically references a Windows Update FQDN tag, and there are no Linux-specific scenarios or tools mentioned. This creates a bias toward Windows users and omits guidance for Linux users.
Recommendations:
  • Add Azure CLI (az group delete) and Bash examples alongside the PowerShell example for resource cleanup.
  • Include Linux-relevant FQDN tags or application rule examples (e.g., Ubuntu repositories) in the firewall policy.
  • Ensure that all command-line instructions are provided in both PowerShell and Bash/Azure CLI formats.
  • Mention cross-platform tools and patterns, not just Windows-specific ones, to ensure parity for Linux users.

Page-Level Analysis

Windows First Missing Linux Example Windows Tools
Summary:
The documentation demonstrates a Windows bias by exclusively deploying and referencing Windows Server 2019 virtual machines for testing, instructing users to use Remote Desktop and Internet Explorer (both Windows-specific tools), and omitting any mention or example of Linux-based virtual machines or tools for firewall validation. While deployment steps are provided for both Azure CLI and PowerShell, the validation and testing sections assume a Windows environment only.
Recommendations:
  • Include parallel instructions for deploying and testing with Linux virtual machines, such as Ubuntu or CentOS.
  • Provide examples of connecting to Linux VMs using SSH, and testing allowed/blocked outbound connections with tools like curl or wget.
  • Mention and demonstrate browser-based validation steps that are OS-agnostic, or show how to test connectivity from a Linux shell.
  • Avoid referencing only Windows-specific tools (e.g., Remote Desktop, Internet Explorer) and instead offer cross-platform alternatives.
  • Explicitly state that the scenario works for both Windows and Linux VMs, and provide guidance for both.