Container Registry
149
Total Pages
126
Linux-Friendly Pages
23
Pages with Bias
15.4%
Bias Rate
Bias Trend Over Time
Pages with Bias Issues
293 issues found
Showing 226-250 of 293 flagged pages
Container Registry
Azure Container Registry SKU Features and Limits
...articles/container-registry/container-registry-skus.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for key operations (such as changing registry SKU and showing usage), but consistently lists PowerShell examples and references alongside or immediately after CLI examples. There are no Linux/macOS-specific examples or explicit mention of Linux tools, and PowerShell is referenced as a primary alternative to Azure CLI, which may create friction for Linux/macOS users who do not use PowerShell.
Recommendations
- Ensure Azure CLI examples are presented first, as CLI is cross-platform and preferred for Linux/macOS users.
- Clearly indicate that Azure PowerShell is Windows-centric, and suggest Azure CLI for Linux/macOS users.
- Where possible, provide Bash shell examples (using Azure CLI) and clarify that PowerShell examples are optional for Windows users.
- Add explicit notes or sections for Linux/macOS users, highlighting cross-platform tools and workflows.
- Avoid implying parity between Azure CLI and PowerShell unless both are equally supported on all platforms.
Create Pull Request
Container Registry
Manage Public Content in Private Container Registry
...icles/container-registry/buffer-gate-public-content.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for importing images to Azure Container Registry. However, the PowerShell example is given equal prominence and appears immediately after the CLI example, which may create friction for Linux/macOS users. There is no explicit Linux/macOS example or mention of Bash scripting, and PowerShell is primarily a Windows-centric tool, though it is available cross-platform. The documentation does not reference Linux-specific tools or workflows, and the order of examples could imply Windows/PowerShell parity or priority.
Recommendations
- Explicitly mention that Azure CLI is cross-platform and preferred for Linux/macOS users.
- Provide Bash shell scripting examples or clarify that Azure CLI commands work natively in Bash and other Unix shells.
- Consider placing Azure CLI examples before PowerShell examples, or labeling PowerShell as 'for Windows users' if appropriate.
- Add a note that PowerShell is available cross-platform but is more commonly used on Windows.
- Include links or references to Linux/macOS-specific guidance for Azure Container Registry operations.
Container Registry
Store Helm Charts in Azure Container Registry
...es/container-registry/container-registry-helm-repos.md
Low Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation provides command-line examples for Helm and Azure CLI, which are cross-platform tools. However, there is evidence of Windows bias in the use of the 'set' command for environment variables and the lack of explicit Linux/macOS equivalents. The environment variable setup uses 'set', which is Windows-specific, and does not mention 'export' for Linux/macOS. Most other commands are generic and applicable to all platforms, but the initial environment variable example may confuse Linux/macOS users.
Recommendations
- Provide both Windows ('set') and Linux/macOS ('export') commands for setting environment variables.
- Add a note clarifying that Azure CLI and Helm commands are cross-platform and can be run on Windows, Linux, or macOS.
- Where shell commands are shown, specify the shell context (e.g., Bash, PowerShell) or provide alternatives.
- Review all examples for platform-specific syntax and ensure parity.
Container Registry
Azure Container Registry SKU Features and Limits
...articles/container-registry/container-registry-skus.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for key operations (such as changing registry SKU and showing usage), but consistently lists PowerShell examples alongside or after CLI examples without mentioning Linux/macOS shell equivalents (e.g., Bash). There are no explicit Linux/macOS-specific instructions or examples, and PowerShell is referenced without clarifying its cross-platform availability. The documentation does not reference Windows-only tools, but the example pattern may create friction for Linux/macOS users.
Recommendations
- Clarify that Azure CLI commands work on Linux, macOS, and Windows, and are the preferred cross-platform option.
- Explicitly mention Bash or shell environments for Linux/macOS users when referencing Azure CLI.
- Consider providing Bash example blocks for Azure CLI commands, or note that the CLI syntax is identical across platforms.
- When referencing PowerShell, note its cross-platform nature or indicate that it is optional for Windows users.
- List Azure CLI examples first, as it is the most platform-neutral tool.
Container Registry
Azure Container Registry SKU Features and Limits
...articles/container-registry/container-registry-skus.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for key operations (such as changing registry SKU and showing usage), but consistently lists PowerShell examples after CLI and does not provide explicit Linux/macOS shell examples or mention Bash/Zsh. The CLI examples are cross-platform, but the PowerShell examples are Windows-centric. There is no mention of Linux-specific tools or patterns, and no explicit Bash or shell script examples.
Recommendations
- Clarify that Azure CLI commands are cross-platform and can be used on Linux, macOS, and Windows.
- Add explicit Bash/Zsh shell examples where appropriate, especially for Linux/macOS users.
- Mention that Azure PowerShell is available cross-platform, but highlight that CLI is generally preferred for Linux/macOS.
- Consider including links or notes about installing Azure CLI and PowerShell on Linux/macOS.
- Where PowerShell is referenced, add a note for Linux/macOS users about using CLI or PowerShell Core.
Container Registry
Import Container Images to ACR using Azure APIs
...container-registry/container-registry-import-images.md
Low Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation provides examples for both Azure CLI and Azure PowerShell throughout, but consistently presents PowerShell examples alongside CLI, and references PowerShell-specific tools and patterns. There is a minor Windows bias in the use of PowerShell, which is more commonly associated with Windows environments, and in the explicit mention of PowerShell installation and usage. However, Azure CLI is cross-platform and all examples are available for it, mitigating the impact for Linux/macOS users. No Linux-specific tools or shell examples (e.g., Bash) are provided, but the CLI examples are sufficient for Linux parity.
Recommendations
- Clarify that Azure CLI is fully supported on Linux/macOS and is the recommended cross-platform option.
- Consider adding brief Bash shell example snippets for common import scenarios, or explicitly state that Azure CLI commands work identically on Linux/macOS.
- Mention that PowerShell Core is available cross-platform, but highlight Azure CLI as the default for Linux/macOS users.
- Add a note in the prerequisites section indicating that Linux/macOS users should use Azure CLI, and provide a link to CLI installation for those platforms.
Container Registry
Manage Public Content in Private Container Registry
...icles/container-registry/buffer-gate-public-content.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for importing images into Azure Container Registry. However, the PowerShell example is given equal prominence to the CLI example, and PowerShell is a Windows-centric tool, which may create friction for Linux/macOS users. Additionally, the order of tools mentioned when creating a registry lists Azure PowerShell before other tools, which subtly prioritizes Windows tooling. No Linux-specific examples or shell scripts are provided, and there is no explicit mention of Linux/macOS workflows or tools.
Recommendations
- Provide Bash or shell script examples for Linux/macOS users alongside Azure CLI and PowerShell examples.
- Clarify that Azure CLI is cross-platform and recommend it as the primary tool for Linux/macOS users.
- When listing tools, mention Azure CLI before PowerShell to avoid subtle Windows-first bias.
- Add explicit statements or links for Linux/macOS users regarding authentication and registry management workflows.
Container Registry
Azure Container Registry Authentication Options Explained
...ontainer-registry/container-registry-authentication.md
Low Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Minor Windows Tools
Summary
The documentation provides authentication examples for both Azure CLI and Azure PowerShell throughout, but PowerShell is featured equally alongside CLI, which is cross-platform. However, PowerShell examples are given in every section, and the 'Next steps' section lists PowerShell before Linux-native alternatives. There are no explicit Linux/macOS examples (e.g., Bash, shell scripting), and Windows-centric tools (PowerShell) are mentioned as a primary option, even though PowerShell Core is cross-platform. The use of Docker and Azure CLI is platform-neutral, but the documentation does not highlight Linux/macOS usage or shell-specific nuances. The mention of setting DOCKER_COMMAND for Podman is a positive step for Linux parity.
Recommendations
- Add explicit Bash/shell examples for authentication flows, especially for token handling and scripting.
- Clarify that Azure CLI and Docker commands work on Linux/macOS, and provide any OS-specific notes (e.g., file paths, environment variable syntax).
- Balance 'Next steps' by including links to Linux/macOS guides or Bash-based workflows.
- Consider mentioning PowerShell Core's cross-platform nature, or linking to Linux/macOS installation guides.
- Where PowerShell is featured, also show equivalent Bash or shell scripting approaches.
Container Registry
Store Helm Charts in Azure Container Registry
...es/container-registry/container-registry-helm-repos.md
Low Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation is generally cross-platform, as Helm and Azure CLI are available on Windows, Linux, and macOS. However, there are subtle signs of Windows bias: the environment variable example uses the Windows 'set' command instead of the cross-platform 'export', and the prerequisites list Azure PowerShell as an option for creating AKS clusters before mentioning the Azure portal. No explicit Linux/macOS-specific instructions or examples are provided, and the 'set' command may confuse Linux/macOS users. All CLI examples otherwise use cross-platform tools (Helm, Azure CLI), but the ordering and lack of Linux/macOS parity in environment variable examples create minor friction.
Recommendations
- Replace the 'set' command for environment variables with 'export' (or show both, e.g., 'set' for Windows CMD, 'export' for Bash/Linux/macOS).
- Explicitly state that Helm and Azure CLI commands are cross-platform and provide any OS-specific notes where relevant.
- When listing options for creating AKS clusters, mention Azure CLI and Azure portal before Azure PowerShell, or clarify PowerShell is Windows-specific.
- Add a note or section for Linux/macOS users where commands differ (e.g., environment variable syntax).
Container Registry
Manage Public Content in Private Container Registry
...icles/container-registry/buffer-gate-public-content.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for importing images to Azure Container Registry. However, the PowerShell example is presented immediately after the CLI example, and PowerShell is a Windows-centric tool. There are no Linux-specific shell examples (e.g., Bash, shell scripting) or explicit mention of Linux/macOS workflows outside Azure CLI. The CLI example is cross-platform, but the inclusion of PowerShell as a primary alternative may subtly reinforce Windows-centric patterns.
Recommendations
- Clarify that Azure CLI is fully cross-platform and recommended for Linux/macOS users.
- Consider adding a Bash shell example for importing images using Docker CLI (if relevant), or explicitly state that Azure CLI commands work on Linux/macOS.
- Mention that Azure PowerShell is available on Linux/macOS, but is most commonly used on Windows.
- Add a note or section for Linux/macOS users, highlighting any differences or confirming parity.
Container Registry
Azure Container Registry Authentication Options Explained
...ontainer-registry/container-registry-authentication.md
Low Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Minor Windows Tools
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for authentication, but PowerShell (a Windows-centric tool) is featured equally alongside CLI. In several sections, PowerShell examples are given immediately after CLI, and references to PowerShell cmdlets are present throughout. While the CLI is cross-platform, PowerShell is primarily used on Windows, though it is available on Linux/macOS. There is minor bias in the 'Next steps' section, which lists PowerShell after CLI, and in the frequent mention of PowerShell as a primary authentication method. However, Docker and Azure CLI are featured and are cross-platform. The documentation does mention alternative container tools (like podman) and provides guidance for non-Docker environments, which helps Linux parity.
Recommendations
- Clarify that Azure PowerShell is available cross-platform, but is most commonly used on Windows.
- Add explicit Linux/macOS notes or examples where PowerShell is mentioned, indicating that Azure CLI is the recommended tool for Linux/macOS users.
- Consider providing bash shell script examples alongside PowerShell, especially for automation scenarios.
- In sections listing authentication methods, consider listing Azure CLI first, as it is the most universally supported tool.
- Where Docker is referenced, note that podman and other container tools are supported, and provide explicit Linux/macOS command examples where appropriate.
Container Registry
Store Helm Charts in Azure Container Registry
...es/container-registry/container-registry-helm-repos.md
Low Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation provides command examples for Helm and Azure CLI, which are cross-platform tools. However, in the 'Set the following environment variables' section, the command uses 'set' (a Windows CMD syntax) without providing the equivalent Linux/macOS example ('export'). Additionally, the order of Kubernetes cluster creation options lists Azure CLI first, then PowerShell, then Portal, which is a minor 'windows_first' bias. All other commands use cross-platform syntax or Bash-style variables, but the initial environment variable example may confuse Linux/macOS users.
Recommendations
- Provide both Windows ('set') and Linux/macOS ('export') syntax for environment variable examples.
- Clarify that Azure CLI commands are cross-platform and can be run on Windows, Linux, and macOS.
- When listing options for cluster creation, consider mentioning Azure CLI and Portal before PowerShell, or note PowerShell is Windows-specific.
- Review all command snippets to ensure they use Bash-style syntax or provide alternatives for Windows CMD/PowerShell where relevant.
Container Registry
Import Container Images to ACR using Azure APIs
...container-registry/container-registry-import-images.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation provides examples for both Azure CLI and Azure PowerShell throughout, but consistently lists Azure PowerShell examples after Azure CLI. Azure PowerShell is a Windows-centric tool, but Azure CLI is cross-platform. No Windows-only tools or patterns are prioritized, and all examples are available for both platforms. There are no missing Linux/macOS examples, and no exclusive mention of Windows tools. The only minor bias is the ordering of examples, with Azure CLI (cross-platform) shown first, followed by Azure PowerShell (Windows-centric).
Recommendations
- Maintain the current ordering, as Azure CLI is cross-platform and shown first.
- Consider explicitly stating that Azure CLI commands work on Linux/macOS/Windows, while Azure PowerShell is primarily for Windows users.
- Add a brief note at the top clarifying that all Azure CLI examples are suitable for Linux/macOS/Windows, and PowerShell examples are for Windows or PowerShell Core users.
Container Registry
Azure Container Registry SKU Features and Limits
...articles/container-registry/container-registry-skus.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for key operations (such as changing registry SKU and showing usage), but consistently lists Azure PowerShell after Azure CLI and includes explicit PowerShell code blocks. There are no Linux/macOS-specific examples or mentions of Bash or shell scripting, and the PowerShell example is given equal prominence to the CLI example. However, Azure CLI is cross-platform and is listed first, mitigating most bias. No Windows-only tools or patterns are mentioned, and the documentation does not exclude Linux/macOS users from completing any tasks.
Recommendations
- Clarify that Azure CLI is cross-platform and preferred for Linux/macOS users.
- Add explicit Bash/shell script examples where appropriate, especially for common operations.
- Mention that Azure PowerShell is primarily for Windows users, and provide guidance for Linux/macOS users to use Azure CLI.
- Consider reordering examples so that CLI (cross-platform) is always shown first, and PowerShell is clearly marked as Windows-specific.
Container Registry
Azure Container Registry SKU Features and Limits
...articles/container-registry/container-registry-skus.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for key operations (such as changing registry SKU), but consistently lists PowerShell examples after CLI and does not provide explicit Linux/macOS shell examples (e.g., Bash). The CLI examples are cross-platform, but the PowerShell examples are Windows-centric. There is no mention of Linux-specific tools or patterns, and no explicit guidance for Linux/macOS users. REST API references are included, but no curl or Bash examples are provided.
Recommendations
- Clarify that Azure CLI commands are cross-platform and work on Linux/macOS as well as Windows.
- Add Bash/curl examples for REST API operations to demonstrate Linux usage.
- Explicitly mention Linux/macOS compatibility where relevant, especially in sections referencing Azure CLI.
- Consider including Linux/macOS shell screenshots or terminal prompts to reinforce parity.
- If PowerShell is referenced, note that PowerShell Core is available cross-platform, but most Linux users will use Bash or Zsh.
Container Registry
Manage Public Content in Private Container Registry
...icles/container-registry/buffer-gate-public-content.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for importing images to Azure Container Registry. However, the PowerShell example is given equal prominence and appears immediately after the CLI example, which may create friction for Linux/macOS users. The mention of Azure PowerShell as a primary tool, without explicit reference to Bash or Linux-native alternatives, suggests a mild Windows bias. All examples are cross-platform (Azure CLI and PowerShell both run on Linux/macOS), but the documentation does not highlight this fact or provide Bash shell-specific guidance.
Recommendations
- Clarify that Azure PowerShell and Azure CLI are both cross-platform, and explicitly mention their availability on Linux/macOS.
- Provide Bash shell or Linux-native command examples (e.g., using Docker CLI directly) where relevant.
- Consider listing Azure CLI examples first, as it is more commonly used on Linux/macOS.
- Add a note for Linux/macOS users about running Azure CLI and PowerShell in their environments.
Container Registry
Azure Container Registry Authentication Options Explained
...ontainer-registry/container-registry-authentication.md
Low Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Minor Windows Tools
Summary
The documentation provides authentication examples for Azure Container Registry using both Azure CLI and Azure PowerShell, with PowerShell examples and references appearing throughout. While Azure CLI is cross-platform, PowerShell is primarily associated with Windows, though it is available on Linux/macOS. The documentation sometimes presents PowerShell examples alongside or after CLI examples, and references to PowerShell cmdlets are frequent. There is a minor tendency to mention Windows-associated tools (PowerShell) and patterns, but Linux/macOS users can complete all tasks using Azure CLI and Docker. The documentation also acknowledges alternative container tools (like podman) and provides guidance for their use, which improves parity.
Recommendations
- Clearly indicate that Azure CLI is fully cross-platform and preferred for Linux/macOS users.
- Where PowerShell examples are given, explicitly note that PowerShell Core is available on Linux/macOS, or provide links to installation instructions for those platforms.
- Consider providing bash shell script examples for common authentication flows, especially for scenarios involving scripting or CI/CD on Linux.
- When listing authentication methods or examples, consistently present Azure CLI (cross-platform) before PowerShell (Windows-associated).
- Add a brief note in the 'Next steps' section about Linux/macOS parity, e.g., 'All Azure CLI examples work on Linux/macOS as well as Windows.'
Container Registry
Import Container Images to ACR using Azure APIs
...container-registry/container-registry-import-images.md
Low Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all import scenarios. However, PowerShell is a Windows-centric tool, and its inclusion alongside Azure CLI throughout the page may create a perception of Windows bias. Additionally, in some sections, PowerShell examples or references appear before or alongside Azure CLI, which can subtly reinforce Windows-first patterns. There are no explicit Windows-only tools or missing Linux/macOS examples, since Azure CLI is fully cross-platform and all commands are shown for both tools.
Recommendations
- Make it clear that Azure CLI is cross-platform and preferred for Linux/macOS users, while PowerShell is primarily for Windows (unless using PowerShell Core).
- Consider showing Azure CLI examples first in each section, or grouping CLI and PowerShell examples so CLI is the default.
- Add a brief note at the top clarifying that all Azure CLI commands work on Linux, macOS, and Windows, and that PowerShell examples are optional for users on Windows.
- If possible, provide Bash shell scripting examples for advanced scenarios, or link to Linux/macOS-specific guidance.
- Ensure that references to installing Azure CLI and PowerShell include links for Linux/macOS installation.
Container Registry
Store Helm Charts in Azure Container Registry
...es/container-registry/container-registry-helm-repos.md
Low Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation provides command-line examples for Helm and Azure CLI, which are cross-platform, but in the 'Set up Helm client' section, the environment variable is set using the Windows-style 'set' command without a Linux/macOS equivalent. Additionally, the order of Kubernetes cluster creation options lists Azure CLI, PowerShell, and Portal, with PowerShell (Windows-centric) mentioned before Portal. There are no explicit Linux/macOS-specific examples or notes, and the only environment variable example is Windows-first.
Recommendations
- For environment variable setup, provide both Windows ('set') and Linux/macOS ('export') examples, e.g., 'export ACR_NAME=<container-registry-name>' for Bash.
- When listing options for creating AKS clusters, mention cross-platform tools (Azure CLI) first, then platform-specific tools (PowerShell), and clarify their OS compatibility.
- Add a note clarifying that all CLI commands (Helm, Azure CLI) work on Linux/macOS, and provide explicit Bash examples where relevant.
- Review all command snippets to ensure they are OS-neutral or provide alternatives for both Windows and Linux/macOS users.
Container Registry
Store Helm Charts in Azure Container Registry
...es/container-registry/container-registry-helm-repos.md
Low Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation is generally cross-platform, focusing on Helm and Azure CLI, which are available on Windows, Linux, and macOS. However, there are minor signs of Windows bias: the environment variable setup uses the Windows-style 'set' command without a Linux/macOS equivalent, and the order of Kubernetes cluster creation options lists Azure PowerShell before the Azure portal and Azure CLI. No PowerShell-specific commands are given, and most CLI examples use bash syntax, but the lack of explicit Linux/macOS instructions for environment variables may cause friction.
Recommendations
- Add Linux/macOS equivalents for environment variable setup, e.g., 'export ACR_NAME=<container-registry-name>' alongside 'set' for Windows.
- When listing options for creating AKS clusters, consider listing Azure CLI first, as it is the most cross-platform tool.
- Explicitly state that all CLI commands are cross-platform and, where relevant, provide both Windows and Linux/macOS command variants.
- Review for any other commands (e.g., file operations) that may differ between platforms and clarify usage.
Container Registry
Import Container Images to ACR using Azure APIs
...container-registry/container-registry-import-images.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation provides parity between Azure CLI and Azure PowerShell throughout, but consistently presents Azure CLI examples first, followed by Azure PowerShell. Azure CLI is fully cross-platform (Linux, macOS, Windows), while PowerShell is traditionally Windows-centric, though now available cross-platform. No Windows-only tools or patterns are used, and all examples are equally applicable to Linux/macOS users. There are no missing Linux/macOS examples, and no exclusive mention of Windows tools.
Recommendations
- Consider explicitly stating that Azure CLI is cross-platform and recommended for Linux/macOS users.
- Add a brief note clarifying that Azure PowerShell is available on Linux/macOS, but Azure CLI is often preferred for those environments.
- Optionally, reorder or alternate the order of CLI and PowerShell examples to avoid 'windows_first' bias.
- Ensure links to Azure CLI installation instructions highlight Linux/macOS options.
Container Registry
Azure Container Registry SKU Features and Limits
...articles/container-registry/container-registry-skus.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for key tasks (such as changing registry SKU and showing registry usage), but consistently lists PowerShell examples alongside or after CLI, and references PowerShell cmdlets in the text. There are no explicit Linux/macOS-specific instructions or examples (e.g., Bash, shell scripting, or CLI-only workflows), and the CLI examples do not clarify their cross-platform compatibility. The documentation does not mention Linux tools or patterns, nor does it highlight CLI as the preferred cross-platform method. This creates minor friction for Linux/macOS users, though all tasks can be completed using Azure CLI, which is cross-platform.
Recommendations
- Explicitly state that Azure CLI commands are cross-platform and preferred for Linux/macOS users.
- Provide Bash/shell scripting examples or clarify CLI usage in Linux/macOS environments.
- List Azure CLI examples before PowerShell examples, or group them under clear cross-platform and Windows sections.
- Add a note indicating that PowerShell examples are primarily for Windows users, while CLI is recommended for Linux/macOS.
- Consider including links to Azure CLI installation and usage guides for Linux/macOS.
Container Registry
Manage Public Content in Private Container Registry
...icles/container-registry/buffer-gate-public-content.md
Low Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for importing images to Azure Container Registry, but the PowerShell example is given equal prominence and is presented immediately after the CLI example. There are no Linux-specific shell examples (e.g., Bash), and PowerShell is not exclusive to Windows but is most commonly associated with Windows environments. The documentation does not reference Windows-only tools, but the order and parity of examples may subtly favor Windows users.
Recommendations
- Add explicit Bash or Linux shell examples for image import, especially since Azure CLI is cross-platform and commonly used on Linux/macOS.
- Clarify that Azure PowerShell is available cross-platform, but highlight Azure CLI as the primary tool for Linux/macOS users.
- Consider showing Azure CLI examples first and labeling PowerShell as an alternative for Windows users.
- Mention that Azure Cloud Shell supports both CLI and PowerShell, but Bash is the default for Linux/macOS users.
Container Registry
Store Helm Charts in Azure Container Registry
...es/container-registry/container-registry-helm-repos.md
Low Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation is largely cross-platform, focusing on Helm and Azure CLI, which are available on Windows, Linux, and macOS. However, there are subtle signs of Windows bias: (1) The environment variable setup uses the Windows-style 'set' command without showing the Linux/macOS equivalent ('export'), and (2) the order of Kubernetes cluster creation options lists Azure CLI, PowerShell, and Portal, with PowerShell (Windows-centric) mentioned before Portal. No explicit Linux/macOS examples are given for environment variable setup, and no Linux-specific tools or shell patterns are shown.
Recommendations
- Add Linux/macOS equivalents for environment variable setup, e.g., 'export ACR_NAME=<container-registry-name>' alongside 'set'.
- When listing options for Kubernetes cluster creation, consider mentioning Azure CLI and Portal first, or clarify PowerShell is Windows-specific.
- Review all shell command examples to ensure both Windows and Linux/macOS users are supported, especially for environment variables and file operations.
- Explicitly state that all commands are cross-platform unless otherwise noted, and link to platform-specific installation guides for Helm and Azure CLI.
Container Registry
Import Container Images to ACR using Azure APIs
...container-registry/container-registry-import-images.md
Low Priority
View Details →
Detected Bias Types
Windows First
Summary
The documentation provides parity between Azure CLI and Azure PowerShell throughout, but consistently presents Azure PowerShell examples alongside Azure CLI, and sometimes references PowerShell-specific patterns (e.g., cmdlets, module installation). However, both tools are cross-platform and supported on Linux/macOS as well as Windows. No Windows-only tools or Windows-specific instructions are given. There are no missing Linux/macOS examples, but Azure PowerShell is often associated with Windows in user perception, and its inclusion may create a minor bias.
Recommendations
- Clarify that both Azure CLI and Azure PowerShell are fully supported on Linux and macOS, not just Windows.
- Consider adding a brief note at the start of the article indicating that all examples work on Linux/macOS as well as Windows.
- If possible, include a Bash shell example for Azure CLI to reinforce Linux parity.
- Explicitly mention that Azure PowerShell can be used on Linux/macOS, and link to installation instructions for those platforms.