196
Total Pages
154
Linux-Friendly Pages
42
Pages with Bias
21.4%
Bias Rate

Bias Trend Over Time

Pages with Bias Issues

198 issues found
Showing 76-100 of 198 flagged pages
Container Apps Tutorial: Build and deploy your app to Azure Container Apps ...main/articles/container-apps/tutorial-code-to-cloud.md
Medium Priority View Details →
Scanned: 2026-01-14 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy 🔧 Windows Tools Windows First
Summary
The documentation provides both Bash and PowerShell examples for nearly every command, but PowerShell coverage is unusually extensive, including custom objects and Azure PowerShell cmdlets. Some steps (e.g., Docker login) use Windows-specific PowerShell cmdlets (Connect-AzContainerRegistry), and PowerShell examples are shown as first-class citizens throughout. There is little explicit mention of Linux/macOS-specific patterns or troubleshooting, and PowerShell is presented as the alternative to Bash, which may imply a Windows-first orientation. However, Bash examples are present and generally sufficient for Linux/macOS users.
Recommendations
  • Add explicit notes clarifying that Bash examples work on Linux/macOS and that PowerShell is primarily for Windows users.
  • Where PowerShell cmdlets are used (e.g., Connect-AzContainerRegistry), provide the equivalent Bash/Azure CLI command for Linux/macOS.
  • Include troubleshooting tips for common Linux/macOS issues (e.g., file permissions, environment variable syntax differences).
  • Consider reordering examples so Bash/Azure CLI is presented first, or clarify parity between platforms.
  • Review included files (e.g., container-apps-create-cli-steps.md) to ensure no hidden Windows bias.
Container Apps Code to cloud options in Azure Container Apps .../main/articles/container-apps/code-to-cloud-options.md
Medium Priority View Details →
Scanned: 2026-01-13 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy 🔧 Windows Tools
Summary
The documentation page demonstrates a moderate Windows bias. Visual Studio and Visual Studio Code are highlighted as primary code editor options, both of which are strongly associated with Windows (though VS Code is cross-platform). The 'Infrastructure as code' section mentions PowerShell before Bash, and the CLI examples and tooling references (Azure CLI, Azure Developer CLI) do not provide explicit parity or examples for Linux/macOS users. There are no references to Linux-specific editors, shell environments, or workflows, and Windows-centric tools are mentioned first or exclusively.
Recommendations
  • Include Linux/macOS-specific examples and workflows, such as using Bash or zsh for CLI automation.
  • Mention and provide examples for popular Linux editors (e.g., Vim, Emacs, JetBrains IDEs) alongside Visual Studio.
  • Ensure CLI instructions and scripts are shown for both PowerShell and Bash, with clear cross-platform guidance.
  • Add explicit notes about cross-platform compatibility for tools like Azure CLI and Azure Developer CLI.
  • Balance the order of tool mentions (e.g., Bash before or alongside PowerShell) to avoid Windows-first impressions.
Container Apps Use a private endpoint with an Azure Container Apps environment ...articles/container-apps/how-to-use-private-endpoint.md
Medium Priority View Details →
Scanned: 2026-01-13 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Windows First Missing Linux Example Powershell Heavy 🔧 Windows Tools
Summary
The documentation page demonstrates a notable Windows bias, especially in the verification and VM creation sections. The portal-based instructions exclusively use Windows Server images for VM creation and only provide PowerShell commands for DNS verification, with no mention of Linux VM options or equivalent Linux shell commands. The Azure CLI instructions for VM creation also default to a Windows image, and there are no Linux-specific examples or guidance for users who prefer or require Linux environments.
Recommendations
  • Add parallel Linux VM creation instructions in both portal and CLI sections, using a popular Linux image (e.g., Ubuntu).
  • Provide Linux shell equivalents (e.g., using 'dig' or 'nslookup' in Bash) for DNS verification steps.
  • Explicitly mention that either Windows or Linux VMs can be used for testing, and clarify any differences in steps.
  • Alternate or balance the order of Windows and Linux examples to avoid implicit prioritization.
  • Where PowerShell is used, offer Bash or other Linux shell alternatives.
Container Apps Manage environment variables on Azure Container Apps .../main/articles/container-apps/environment-variables.md
Medium Priority View Details →
Scanned: 2026-01-13 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides example workflows for Azure portal, Azure CLI, and PowerShell. PowerShell is presented as a first-class method alongside CLI, with detailed, multi-step instructions and references to Windows-specific cmdlets and object models. There are no Linux/macOS shell or scripting examples (e.g., Bash, zsh), nor any mention of Linux-specific tools or patterns. The CLI examples are cross-platform, but PowerShell is Windows-centric and is described in greater detail than CLI, suggesting a Windows-oriented bias.
Recommendations
  • Add Bash/zsh shell scripting examples for managing environment variables, especially for automation scenarios on Linux/macOS.
  • Clarify that Azure CLI commands work on Linux/macOS and Windows equally, and consider showing CLI examples before PowerShell.
  • Reduce the length and detail of PowerShell sections unless parity is provided for Linux shell scripting.
  • Explicitly mention cross-platform support for Azure CLI and provide links to Linux/macOS installation guides.
  • If PowerShell is shown, consider including PowerShell Core (pwsh) usage notes for Linux/macOS users.
Container Apps Observability of managed Java components in Azure Container Apps ...ob/main/articles/container-apps/java-component-logs.md
Medium Priority View Details →
Scanned: 2026-01-13 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both Bash and PowerShell examples for querying logs via Azure CLI, but PowerShell examples are consistently shown after Bash. However, there is a subtle Windows bias: the variable assignment example for Bash uses 'SET', which is a Windows CMD command, not valid in Bash on Linux/macOS. The PowerShell examples are complete and use native syntax, while the Bash examples use a Windows-centric pattern for variable assignment, potentially confusing Linux/macOS users.
Recommendations
  • Replace 'SET $WORKSPACE_ID=<WORKSPACE_ID>' in Bash examples with 'WORKSPACE_ID=<WORKSPACE_ID>' to use proper Bash syntax.
  • Add explicit notes clarifying which examples are for Linux/macOS Bash and which are for Windows CMD/PowerShell.
  • Ensure all CLI examples use syntax valid for the target shell (e.g., Bash for Linux/macOS, CMD for Windows, PowerShell for Windows).
  • Consider showing Bash (Linux/macOS) examples first, or side-by-side, to avoid implicit prioritization of Windows tools.
Container Apps Manage secrets in Azure Container Apps ...cs/blob/main/articles/container-apps/manage-secrets.md
Medium Priority View Details →
Scanned: 2026-01-13 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example
Summary
The documentation provides examples for Azure Portal, ARM template, Azure CLI, and PowerShell. PowerShell examples are included for most tasks, but there are no explicit Linux/macOS shell examples (e.g., Bash scripts), nor is there mention of Linux-specific tools or workflows. PowerShell is a Windows-centric tool, and its inclusion without equivalent Bash or shell examples creates a bias. Additionally, PowerShell examples are presented alongside CLI and ARM, but never after a Linux shell example. Some features (Key Vault secret references, secret volume mounts) are explicitly unsupported in PowerShell, but there is no guidance for Linux users in those cases.
Recommendations
  • Add explicit Bash or Linux shell examples for all Azure CLI commands, showing environment variable usage and typical Linux workflows.
  • Clarify that Azure CLI commands work cross-platform and provide notes or links for Linux/macOS installation and usage.
  • Where PowerShell is unsupported (e.g., Key Vault secret references, secret volume mounts), provide alternative Linux/macOS guidance or explicitly state how to accomplish the task using Azure CLI or ARM templates.
  • Consider reordering examples so that CLI (cross-platform) comes before PowerShell, or provide a Linux/macOS tab.
  • Add troubleshooting notes for common Linux/macOS issues (permissions, file paths, etc.) when mounting secrets as volumes.
Container Apps Managed identities in Azure Container Apps .../blob/main/articles/container-apps/managed-identity.md
Medium Priority View Details →
Scanned: 2026-01-13 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Powershell Heavy 🔧 Windows Tools
Summary
The documentation provides a PowerShell example for retrieving tokens from the managed identity endpoint, but does not offer equivalent Linux/macOS shell (e.g., Bash/curl) examples. This may create friction for users on non-Windows platforms. Additionally, the use of PowerShell-specific environment variable syntax and tools (Invoke-RestMethod) is Windows-centric.
Recommendations
  • Add Bash/curl examples alongside PowerShell for token retrieval from the managed identity endpoint.
  • Use cross-platform environment variable syntax in examples (e.g., $IDENTITY_ENDPOINT for PowerShell, $IDENTITY_ENDPOINT for Bash).
  • Explicitly mention that the Azure CLI commands work on Linux/macOS as well as Windows.
  • Where PowerShell is shown, provide a tab or section for Bash/curl to ensure parity.
Container Apps Monitor Azure Container Apps metrics ...zure-docs/blob/main/articles/container-apps/metrics.md
Medium Priority View Details →
Scanned: 2026-01-13 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
🔧 Windows Tools Windows First
Summary
The documentation references both Azure CLI and Azure PowerShell cmdlets for retrieving metrics, but PowerShell is mentioned alongside CLI as a primary method, and links to PowerShell documentation are provided. There are no explicit Linux/macOS command examples, nor is Bash or shell scripting mentioned. The use of 'cmdlets' and PowerShell terminology is Windows-centric, and Windows tools are referenced before any Linux equivalents (which are absent).
Recommendations
  • Include explicit Bash or shell examples for metric retrieval using Azure CLI, demonstrating usage on Linux/macOS.
  • Clarify that Azure CLI works cross-platform and provide links to installation/use guides for Linux/macOS.
  • If PowerShell is mentioned, also mention that PowerShell Core is available cross-platform, or provide parity with Bash examples.
  • Avoid using Windows-specific terminology (e.g., 'cmdlets') without also referencing Linux/macOS equivalents.
  • Add a section or note for Linux/macOS users outlining any differences or considerations.
Container Apps Tutorial: Build and deploy your app to Azure Container Apps ...main/articles/container-apps/tutorial-code-to-cloud.md
Medium Priority View Details →
Scanned: 2026-01-13 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy 🔧 Windows Tools Windows First
Summary
The documentation provides both Bash and PowerShell examples for most commands, but PowerShell coverage is extensive and sometimes more detailed, including use of Azure PowerShell modules and Windows-centric tooling (e.g., Connect-AzContainerRegistry). PowerShell examples are given equal or greater prominence than Bash, and some steps (like Log Analytics workspace creation) are only shown in PowerShell. There is also mention of Docker Desktop for Windows, macOS, and Linux, but the instructions and command syntax are often tailored to Windows/PowerShell users. Linux/macOS users may need to adapt PowerShell examples or infer Bash equivalents for some advanced steps.
Recommendations
  • Ensure every PowerShell example has a corresponding Bash example, especially for advanced Azure resource management steps (e.g., Log Analytics workspace creation).
  • When referencing Docker Desktop, provide explicit Linux-native Docker installation and usage instructions, not just a link.
  • Avoid using Windows-specific Azure PowerShell modules (e.g., Connect-AzContainerRegistry) without Bash/Azure CLI equivalents.
  • Present Bash examples first, as Bash is the default shell on Linux/macOS.
  • Add explicit notes or tabs for Linux/macOS users where command syntax or tooling differs.
  • Review included markdown files ([container-apps-create-cli-steps.md], etc.) for hidden Windows bias.
Container Apps Code to cloud options in Azure Container Apps .../main/articles/container-apps/code-to-cloud-options.md
Medium Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy 🔧 Windows Tools
Summary
The documentation page demonstrates a moderate Windows bias. Visual Studio and Visual Studio Code (both Microsoft products, with Visual Studio being Windows-only) are emphasized as primary code editor options for deploying to Azure Container Apps. The CLI section mentions both PowerShell and Bash, but PowerShell is listed first, and there are no explicit Linux/macOS-specific examples or tool recommendations. No Linux-first editors (e.g., JetBrains IDEs, Vim, Emacs) or Linux/macOS deployment workflows are mentioned. The resources and next steps sections also prioritize Visual Studio and Visual Studio Code, reinforcing a Windows-centric workflow.
Recommendations
  • Add explicit examples and guidance for Linux/macOS users, including using Bash and other shell environments.
  • Include alternative code editors popular on Linux/macOS (e.g., JetBrains IDEs, Vim, Emacs) in the 'Code editor' section.
  • Provide parity in CLI instructions, showing both PowerShell and Bash commands side-by-side.
  • Mention Docker and container tooling installation steps for Linux/macOS platforms.
  • Balance resource links to include Linux/macOS-focused tutorials and workflows.
Container Apps Observability of managed Java components in Azure Container Apps ...ob/main/articles/container-apps/java-component-logs.md
Medium Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both Bash and PowerShell examples for querying logs via Azure CLI, but in each case, the PowerShell example is presented immediately after Bash and is more detailed, using specific PowerShell cmdlets (Invoke-AzOperationalInsightsQuery) that are Windows-centric. The variable assignment uses 'SET' in Bash, which is a Windows command, not standard in Linux Bash, suggesting a Windows-first approach. There are no Linux-specific tools or patterns mentioned, and the documentation does not clarify platform differences or recommend Linux-native alternatives.
Recommendations
  • Replace 'SET' with 'export' for Bash variable assignment to reflect standard Linux usage.
  • Clarify platform differences in variable assignment and command syntax (e.g., use 'export WORKSPACE_ID=...' for Bash, '$WORKSPACE_ID = ...' for PowerShell).
  • Provide Linux-native CLI examples and explicitly mention compatibility with Linux shells.
  • Avoid using Windows-centric terminology or tools unless necessary, and ensure parity in example detail for both platforms.
  • Add notes or sections for troubleshooting or usage on Linux systems, including common shell environments (bash, zsh, etc.).
Container Apps Tutorial: Enable Azure Container Apps on Azure Arc-enabled Kubernetes ...in/articles/container-apps/azure-arc-enable-cluster.md
Medium Priority View Details →
Scanned: 2026-01-11 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 PowerShell examples for all steps, but PowerShell is featured as the only alternative to Azure CLI, with no mention of Linux-specific shell environments (e.g., Bash, Zsh) or macOS. The PowerShell examples are presented alongside CLI, suggesting a Windows-centric approach. There are no Linux-specific instructions, troubleshooting tips, or references to Linux tools or shell scripting patterns. The use of environment variables is shown in Bash for CLI, but the PowerShell alternative is always present and sometimes appears first. No Linux-only issues, such as file permissions or package installation, are discussed.
Recommendations
  • Add explicit Bash and/or Zsh examples for Linux/macOS users, not just generic Azure CLI blocks.
  • Include troubleshooting notes for Linux environments (e.g., file permissions, package dependencies, path differences).
  • Mention that PowerShell is available cross-platform, but clarify that Bash is the default on most Linux distributions.
  • Where environment variables are set, provide examples using export (Bash) and note differences in variable syntax between shells.
  • Add a section or notes on running these commands on Linux, including prerequisites such as installing kubectl and Azure CLI via package managers.
  • Consider reordering examples so that Bash/Azure CLI comes first, followed by PowerShell, to avoid Windows-first perception.
Container Apps Tutorial: Communication between microservices in Azure Container Apps ...es/container-apps/communicate-between-microservices.md
Medium Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Powershell Heavy Windows First
Summary
The documentation provides both Bash and PowerShell examples for all command-line steps, but the PowerShell instructions are notably more verbose and detailed, especially for deployment steps. In some sections, the PowerShell example is presented after the Bash example, but the PowerShell workflow is described in greater detail, including object creation and parameter passing, which may be confusing or intimidating for Linux users. There are no Linux-specific tools or patterns mentioned, and the documentation does not address Linux-only scenarios or troubleshooting. The overall structure and depth of PowerShell coverage suggest a bias toward Windows users.
Recommendations
  • Ensure Bash and PowerShell examples are equally detailed, especially for complex steps like container app deployment.
  • Add Linux-specific troubleshooting tips or notes, such as common issues with permissions, environment variables, or Docker on Linux.
  • Include references to Linux-native tools or workflows where relevant (e.g., using curl, jq, or native Docker commands).
  • Consider adding a section or appendix for Linux users, highlighting any differences or best practices when using Azure CLI and Docker on Linux.
  • Review the order and prominence of examples to avoid giving the impression that PowerShell is the preferred or default approach.
Container Apps Azure Container Apps ARM and YAML template specifications ...cles/container-apps/azure-resource-manager-api-spec.md
Medium Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
🔧 Windows Tools Windows First
Summary
The documentation references both Azure CLI and Azure PowerShell for managing Azure Container Apps, but PowerShell (a Windows-centric tool) is mentioned explicitly and separately, with a link to installation instructions. The update instructions for CLI are given first, followed by PowerShell, and there is no mention of Linux-specific tools or shell environments (e.g., Bash, zsh) beyond the CLI commands. No explicit PowerShell examples are given, but the presence and ordering of PowerShell references indicate a mild Windows bias. All code examples are platform-neutral (ARM, YAML, JSON), and CLI commands are shown in Bash syntax, which is cross-platform.
Recommendations
  • Clarify that Azure CLI works on Linux, macOS, and Windows, and provide installation/update instructions for all platforms.
  • Include links to Azure CLI installation for Linux and macOS alongside PowerShell installation instructions.
  • If referencing PowerShell, also mention Bash/zsh for Linux/macOS users, or provide equivalent shell instructions where relevant.
  • Avoid implying PowerShell is required or preferred for non-Windows users; highlight CLI as the recommended cross-platform tool.
  • Consider adding a note or section on cross-platform usage and shell compatibility for all commands.
Container Apps Deploy the Dapr extension for Azure Functions in Azure Container Apps ...in/articles/container-apps/dapr-functions-extension.md
Medium Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both PowerShell and curl examples for invoking Azure Functions and viewing logs, but PowerShell is consistently presented first in each tabbed example. This ordering may subtly prioritize Windows users. There are no Linux-specific tools or shell patterns (e.g., bash scripting, environment variable usage) shown, and no explicit mention of Linux or cross-platform considerations. However, the use of Azure CLI and curl is cross-platform, and no Windows-only tools are used.
Recommendations
  • Alternate the order of PowerShell and curl examples, or present curl first to reflect its cross-platform nature.
  • Explicitly mention that all CLI and curl commands work on Linux, macOS, and Windows.
  • Add bash script examples for common tasks, such as setting environment variables or automating deployment steps.
  • Include notes or tips for Linux users, such as using environment variables in bash, or differences in shell syntax.
  • Ensure screenshots and portal instructions do not assume a Windows environment.
Container Apps Quickstart: Deploy your first container app with containerapp up ...-docs/blob/main/articles/container-apps/get-started.md
Medium Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both Bash and PowerShell examples for the main Azure CLI command, but the PowerShell example is given equal prominence to Bash, which may suggest a slight Windows bias. There are no Linux-specific tools or troubleshooting steps, and the cleanup command is only shown in Azure CLI syntax, which is cross-platform. However, the presence of PowerShell examples and tabs may indicate a tendency to prioritize Windows users or workflows.
Recommendations
  • Add explicit instructions or troubleshooting notes for Linux users, such as handling permissions, shell differences, or common issues.
  • Include examples for other shells commonly used on Linux/macOS, such as zsh or fish, if relevant.
  • Ensure that Bash examples are presented first or with equal prominence to PowerShell, and clarify that Bash is the default on most Linux/macOS systems.
  • Mention platform-specific nuances (e.g., line continuation differences, environment variable syntax) to help users on non-Windows platforms.
  • Consider adding a note that Azure CLI works identically on Linux, macOS, and Windows, and link to platform-specific installation guides.
Container Apps Configure the APM Java agent with Init Containers ...apps/java-application-performance-management-config.md
Medium Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Powershell Heavy Windows First
Summary
The documentation provides both Bash and PowerShell examples for every command, but PowerShell is featured as the only alternative to Bash, which may suggest a Windows-centric approach. There are no Linux-specific tools, patterns, or troubleshooting steps, and PowerShell is presented as the default non-Bash shell, which can imply a bias toward Windows environments. However, all examples are cross-platform (Azure CLI, Docker), and the base container image is Linux-based, so the bias is moderate.
Recommendations
  • Add explicit notes clarifying that Bash examples work on Linux and macOS, and PowerShell examples are for Windows users.
  • Consider including Linux-specific troubleshooting tips or references (e.g., permissions, SELinux, systemd integration) where relevant.
  • Mention alternative shells for Linux users (e.g., zsh, fish) or note that Bash is the default on most Linux distributions.
  • If PowerShell is included for Windows parity, consider also including macOS-specific notes or examples where relevant.
  • Ensure that any references to file paths, environment variables, or OS-specific behaviors are clear for both Windows and Linux users.
Container Apps Generate GitHub Actions workflow with Azure CLI in Azure Container Apps ...lob/main/articles/container-apps/github-actions-cli.md
Medium Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both Bash and PowerShell examples for all Azure CLI commands, but PowerShell is consistently presented as the second option after Bash. There is a clear parity in the examples, but the presence of PowerShell examples throughout the documentation and their explicit labeling may indicate a slight Windows bias, especially for users who expect Linux shell examples to be primary. However, there are no Windows-exclusive tools or patterns, and Linux users are not missing any functionality or instructions.
Recommendations
  • Ensure that Bash examples are presented first, as is currently done, and clarify that Bash examples are suitable for Linux/macOS users.
  • Consider adding a short note at the beginning stating that all commands work cross-platform and that Bash examples are intended for Linux/macOS, while PowerShell is for Windows.
  • If possible, include a generic 'shell' tab or clarify that Bash commands work in most Unix-like environments, including WSL on Windows.
  • Avoid unnecessary emphasis on PowerShell unless there are Windows-specific considerations.
Container Apps View log streams in Azure Container Apps ...ocs/blob/main/articles/container-apps/log-streaming.md
Medium Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Powershell Heavy Windows First
Summary
The documentation provides both Bash and PowerShell examples for all Azure CLI commands, ensuring coverage for both Linux/macOS and Windows users. However, PowerShell examples are given equal prominence to Bash, which can be interpreted as a Windows bias since PowerShell is primarily a Windows shell. Additionally, instructions for stopping the live stream mention both Ctrl-C and Cmd-C, but do not mention Linux-specific shortcuts (though Ctrl-C is universal). No Linux-specific tools, patterns, or troubleshooting steps are mentioned, and Bash is not prioritized over PowerShell.
Recommendations
  • Consider listing Bash examples before PowerShell examples to reflect the cross-platform nature of Azure CLI and the predominance of Bash in cloud-native and container workflows.
  • Explicitly state that Bash examples work on Linux and macOS, and PowerShell examples are for Windows users.
  • Add notes or troubleshooting tips for Linux users, such as handling permissions or common issues with Azure CLI on Linux.
  • If possible, provide examples using native Linux tools (e.g., piping output to grep or tail) to demonstrate Linux-centric workflows.
  • Clarify that Ctrl-C is the universal way to stop the live stream across all platforms.
Container Apps Quickstart: Build and deploy from a repository to Azure Container Apps ...in/articles/container-apps/quickstart-repo-to-cloud.md
Medium Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both Bash and PowerShell examples for environment variable setup and Azure CLI commands, but PowerShell (Windows) is given equal prominence to Bash (Linux/macOS) throughout. There is no explicit prioritization of Linux tools or workflows, and Windows/PowerShell instructions are always present and sometimes appear before or alongside Bash. No Linux-specific troubleshooting, file system, or shell patterns are mentioned, and there is no discussion of platform-specific differences or caveats. The documentation does not mention WSL, nor does it address Linux-specific concerns (e.g., permissions, shell compatibility).
Recommendations
  • Explicitly state platform compatibility for all CLI commands and examples.
  • Prioritize Bash (Linux/macOS) examples before PowerShell (Windows) in each section, or provide a clear default for Linux users.
  • Add notes or troubleshooting tips for Linux-specific issues (e.g., file permissions, shell differences, package managers).
  • Mention WSL for Windows users who want a Linux-like experience.
  • Include links to Linux-specific Azure CLI installation instructions and common Linux workflows.
  • Clarify that all commands work on Linux, macOS, and Windows, and highlight any platform-specific caveats.
Container Apps Tutorial: Scale an Azure Container Apps application .../blob/main/articles/container-apps/tutorial-scaling.md
Medium Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both Bash and PowerShell examples for all Azure CLI commands, ensuring parity in command-line instructions. However, in the 'Send requests' section, the PowerShell example is significantly more complex than the Bash equivalent, and the Bash example uses standard Linux tools (seq, xargs, curl) with direct links to their man pages, while the PowerShell example relies on Windows-specific constructs (RunspacePool, Invoke-WebRequest) and links only to PowerShell documentation. Additionally, instructions for opening a shell are phrased as 'open a new bash shell' for Bash and 'open a new command prompt and enter PowerShell' for PowerShell, subtly prioritizing Windows terminology. The documentation does not mention or provide examples for macOS, nor does it discuss cross-platform alternatives for sending concurrent requests outside of Bash or PowerShell.
Recommendations
  • Add explicit mention that Bash examples work on Linux and macOS, and clarify any platform-specific differences.
  • Provide a cross-platform alternative for sending concurrent requests, such as using Python, which works on Windows, Linux, and macOS.
  • Include links to macOS documentation for Bash tools (curl, xargs, seq), not just Linux man pages.
  • Consider simplifying the PowerShell example or providing a more direct equivalent to the Bash command, to avoid making the Windows workflow appear more complex.
  • Add a note about using Windows Subsystem for Linux (WSL) for Windows users who prefer Bash.
  • Ensure that instructions for opening shells are phrased in a platform-neutral way, e.g., 'Open a terminal window.'
Container Apps Azure Container Apps ARM and YAML template specifications ...cles/container-apps/azure-resource-manager-api-spec.md
Medium Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
🔧 Windows Tools Windows First
Summary
The documentation page demonstrates mild Windows bias by mentioning Azure PowerShell and providing a link to its installation instructions, while not mentioning Linux-specific tools or shell environments (such as Bash, zsh, or Linux package managers) in equivalent detail. The update instructions for Azure CLI are presented using Bash syntax, which is cross-platform, but PowerShell is referenced separately and more prominently. There are no explicit PowerShell command examples, but the documentation refers to Azure PowerShell before listing SDKs for other languages. No Linux-specific patterns, tools, or package managers are mentioned, and there is no guidance for Linux users on updating Azure CLI or extensions using native Linux methods. The documentation does not provide examples or instructions for using Linux-specific shells or environments, nor does it mention cross-platform considerations for template deployment.
Recommendations
  • Add explicit instructions for updating Azure CLI and extensions on Linux, including common package manager commands (e.g., apt, yum, zypper).
  • Include references to Linux shell environments (e.g., Bash, zsh) and clarify that Azure CLI commands work cross-platform.
  • Provide parity by mentioning both Azure PowerShell (Windows) and Bash (Linux/macOS) environments when discussing CLI usage.
  • Add notes or links for installing/updating Azure CLI and PowerShell on Linux and macOS, not just Windows.
  • Ensure that SDK and tool references do not prioritize Windows tools or environments, and clarify cross-platform support where relevant.
Container Apps Quickstart: Deploy your first container app with containerapp up ...-docs/blob/main/articles/container-apps/get-started.md
Medium Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both Bash and PowerShell examples for the main Azure CLI command, but the PowerShell example is given equal prominence, which may indicate a slight Windows bias. There are no Linux-specific troubleshooting steps, nor is there mention of Linux tools or patterns. The cleanup command is shown only in Azure CLI syntax, which is cross-platform, but the overall structure gives Windows users (PowerShell) equal footing, rather than prioritizing Linux/Bash, which is more common in container workflows.
Recommendations
  • Prioritize Bash/Linux examples before PowerShell, as Bash is the default shell on most developer and CI/CD environments for containers.
  • Explicitly mention that Azure CLI works on Linux, macOS, and Windows, and provide links or notes for installing on Linux.
  • Add Linux-specific troubleshooting tips or notes, if any exist (e.g., permissions, networking).
  • Consider including a note about running commands in WSL for Windows users, to encourage parity.
  • If PowerShell is included, clarify its use for Windows users and avoid implying it is the default or preferred shell.
Container Apps Create a zone-redundant container app ...main/articles/container-apps/how-to-zone-redundancy.md
Medium Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides examples for Azure Portal, Azure CLI, and Azure PowerShell. While Azure CLI is cross-platform, Azure PowerShell is primarily used on Windows, and its inclusion as a separate tab with detailed examples may indicate a Windows bias. The documentation does not mention or provide Linux-specific shell examples (e.g., Bash), nor does it reference Linux tools or patterns. The ordering of tabs (Portal, CLI, PowerShell) puts Windows-centric tools before Linux-centric workflows, and PowerShell examples are detailed and prominent.
Recommendations
  • Add explicit Bash shell examples for Linux users, especially for environment variable assignment and command chaining.
  • Clarify that Azure CLI commands work on both Windows and Linux, and provide shell-specific notes where syntax may differ.
  • Consider reordering tabs or explicitly labeling Azure CLI as cross-platform to avoid the impression of Windows-first bias.
  • If PowerShell is included, also include Bash or other Linux shell examples for parity.
  • Reference Linux tools or workflows where appropriate, such as using jq for JSON parsing or curl for API calls.
Container Apps Tutorial: Enable Azure Container Apps on Azure Arc-enabled Kubernetes ...in/articles/container-apps/azure-arc-enable-cluster.md
Medium Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation provides both Azure CLI (bash) and PowerShell examples for all steps, but PowerShell is given equal prominence to bash, which is primarily a Windows shell. There is no explicit Linux shell scripting (e.g., sh, zsh) or mention of Linux-specific patterns or tools. The use of PowerShell tabs and examples throughout may signal a Windows-centric approach, especially since PowerShell is less common on Linux. There are no Linux-specific instructions, troubleshooting, or environment setup notes, and no mention of WSL or Linux package managers for Azure CLI installation.
Recommendations
  • Add explicit Linux shell examples (e.g., sh, zsh) and clarify that bash examples are suitable for Linux/macOS users.
  • Include Linux-specific troubleshooting notes (e.g., permissions, file paths, package manager commands for Azure CLI installation).
  • Clarify that PowerShell examples are primarily for Windows users, and bash/CLI examples are for Linux/macOS.
  • Mention WSL as an option for Windows users who want a Linux-like environment.
  • Add notes about differences in environment variable syntax and file paths between Windows and Linux.
  • Consider providing a Linux-first example order, or at least alternate the order of CLI and PowerShell tabs.