Operator Nexus
233
Total Pages
206
Linux-Friendly Pages
27
Pages with Bias
11.6%
Bias Rate
Bias Trend Over Time
Pages with Bias Issues
34 issues found
Showing 1-25 of 34 flagged pages
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/includes/virtual-machine/quickstart-cleanup-ps.md
...exus/includes/virtual-machine/quickstart-cleanup-ps.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Missing Linux Example
Windows Tools
Windows First
Summary
The documentation page exclusively provides an Azure PowerShell example (Remove-AzResourceGroup) for deleting a resource group, with no mention of equivalent commands or instructions for Linux users (e.g., Azure CLI or Bash). Only Windows-centric tools and patterns are referenced, and no Linux or cross-platform alternatives are presented.
Recommendations
- Add an Azure CLI example (e.g., az group delete --name myResourceGroup) alongside the PowerShell example.
- Include Bash shell instructions for Linux/macOS users.
- Present both Windows and Linux examples in parallel tabs or sections to ensure parity.
- Avoid referencing only Windows tools; mention cross-platform tools like Azure CLI where possible.
- Consider reordering or presenting examples in a way that does not prioritize Windows tools over Linux equivalents.
Create Pull Request
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/includes/virtual-machine/quickstart-prereq-ps.md
...nexus/includes/virtual-machine/quickstart-prereq-ps.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Windows Tools
Summary
The documentation page exclusively uses PowerShell and Az PowerShell module examples, both in Azure Cloud Shell and for local use, without providing any Bash, Azure CLI, or Linux-native alternatives. All command-line instructions and tooling references are Windows-centric, with no mention of Linux or cross-platform approaches.
Recommendations
- Provide equivalent Azure CLI (az) command examples alongside PowerShell examples, as Azure CLI is cross-platform and commonly used on Linux and macOS.
- Include Bash shell instructions for users who prefer or require a Linux-native environment.
- Explicitly mention that Azure Cloud Shell supports both Bash and PowerShell, and show how to select or switch between them.
- Reference installation instructions for Azure CLI on Linux, in addition to PowerShell module installation.
- Ensure that all steps (such as resource group creation) have both PowerShell and CLI/Bash code blocks, clearly labeled.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/includes/kubernetes-cluster/cluster-connect-powershell.md
...ludes/kubernetes-cluster/cluster-connect-powershell.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Windows Tools
Summary
The documentation page demonstrates a Windows bias by exclusively providing Azure PowerShell examples for cluster setup and connection, without offering equivalent Bash/CLI commands for Linux or macOS users. The use of PowerShell-specific syntax and cmdlets, as well as the absence of cross-platform Azure CLI alternatives, makes the instructions less accessible to non-Windows users.
Recommendations
- Provide equivalent Azure CLI (az) command examples alongside PowerShell, using Bash syntax for environment variable assignment and command execution.
- Explicitly mention that both PowerShell and Bash/CLI can be used, and clarify any platform-specific requirements.
- Reorder or parallelize examples so that Linux/macOS (Bash/CLI) and Windows (PowerShell) instructions are given equal prominence.
- Include notes or links to official Azure CLI documentation for users on Linux or macOS.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/includes/kubernetes-cluster/quickstart-cleanup-powershell.md
...es/kubernetes-cluster/quickstart-cleanup-powershell.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Missing Linux Example
Windows Tools
Windows First
Summary
The documentation provides only a Windows PowerShell example (Remove-AzResourceGroup) for deleting the resource group, with no equivalent example or mention of how to perform the same task using Azure CLI, Bash, or other Linux-friendly tools. This prioritizes Windows tooling and omits guidance for Linux/macOS users.
Recommendations
- Add an Azure CLI example (e.g., az group delete --name myResourceGroup) alongside the PowerShell example.
- Include a Bash shell example for Linux/macOS users.
- Present both PowerShell and CLI examples in parallel tabs or sections to ensure equal visibility.
- Review documentation for other instances where only Windows tools are referenced and add cross-platform alternatives.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/includes/kubernetes-cluster/quickstart-prerequisite-powershell.md
...bernetes-cluster/quickstart-prerequisite-powershell.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Windows Tools
Summary
The documentation page demonstrates a strong bias toward Windows and PowerShell usage. All command-line examples use Azure PowerShell cmdlets, with no equivalent Azure CLI (bash) or native Linux shell examples provided. The instructions assume the user is running PowerShell locally or in Cloud Shell, and reference Windows-centric tools and patterns (e.g., Connect-AzAccount, Set-AzContext, New-AzResourceGroup) without mentioning or prioritizing cross-platform alternatives. There is a brief mention of using Bash in Azure Cloud Shell, but all detailed steps and code samples are PowerShell-specific.
Recommendations
- Provide equivalent Azure CLI (az) command examples alongside PowerShell cmdlets for all resource management steps.
- Explicitly mention that Azure CLI can be used from Bash in Cloud Shell and on Linux/macOS systems.
- Reorder instructions or provide parallel sections so that Linux/Bash/Azure CLI usage is not secondary to PowerShell.
- Reference both PowerShell and CLI documentation links where appropriate.
- Clarify that both PowerShell and CLI are cross-platform, and help users choose the tool that best fits their environment.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/howto-cluster-manager.md
.../main/articles/operator-nexus/howto-cluster-manager.md
High Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Windows Tools
Missing Linux Example
Summary
The documentation demonstrates a Windows bias by consistently presenting Azure PowerShell examples alongside Azure CLI and ARM Template, with PowerShell (a Windows-centric tool) given equal prominence to the cross-platform CLI. There are no explicit Linux shell (bash) examples, and the instructions for role assignment and portal usage assume familiarity with Windows-oriented tools and workflows. No mention is made of Linux-native scripting or automation approaches, and the documentation does not clarify that Azure CLI commands are cross-platform or provide Linux-specific usage tips.
Recommendations
- Explicitly state that Azure CLI commands are cross-platform and provide example invocations in bash/zsh (e.g., using environment variables, quoting, or piping output to jq).
- Add Linux shell (bash) script examples for common operations, especially for automation scenarios.
- Clarify that PowerShell examples are primarily for Windows users, and suggest alternatives for Linux/macOS users (such as bash or Azure CLI).
- When describing portal-based steps, mention that the Azure portal is accessible from any OS/browser, and provide keyboard shortcuts or accessibility tips that are not Windows-specific.
- Include references to Linux-native tools (e.g., jq for JSON parsing) when discussing output manipulation.
- Consider the order of examples: present Azure CLI (cross-platform) first, then PowerShell, to avoid implying Windows-first workflows.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/howto-convert-cable-validation-html.md
.../operator-nexus/howto-convert-cable-validation-html.md
High Priority
View Details →
Detected Bias Types
Windows First
Windows Tools
Missing Linux Example
Summary
The documentation shows subtle Windows bias: the sample image path uses backslashes (media\cable-validation-html.png), which is a Windows convention. There is no mention of Linux or macOS in the instructions, nor are there any notes about running the script on non-Windows systems or handling file paths in a cross-platform way. The usage section and file naming also implicitly assume Windows conventions. No Linux-specific instructions, troubleshooting, or screenshots are provided.
Recommendations
- Use forward slashes (/) in file paths in documentation and image references, or clarify that paths should be adapted for the user's OS.
- Explicitly state that the Python script works on Windows, Linux, and macOS, and mention any OS-specific considerations (e.g., file permissions, line endings).
- Provide example commands for running the script on Linux/macOS (e.g., python3 cable-html.py).
- Include a sample screenshot taken from a Linux desktop environment or clarify that the output is platform-independent.
- Mention that the output HTML file can be opened on any OS, and provide guidance for users unfamiliar with their OS's file system.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/howto-use-azure-policy.md
...main/articles/operator-nexus/howto-use-azure-policy.md
High Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation demonstrates subtle Windows bias by referencing PowerShell alongside Azure CLI as the primary tools for policy management, without providing explicit Linux/bash examples or clarifying parity. No Linux-specific tools, commands, or workflows are mentioned, and the phrase 'Azure CLI or PowerShell' may imply a Windows-first approach. There are no examples or guidance tailored for Linux users.
Recommendations
- Explicitly mention and provide examples for both Azure CLI (bash) and PowerShell, clarifying that Azure CLI is fully cross-platform.
- Include sample commands for common tasks (e.g., assigning a policy) using Azure CLI in bash, not just PowerShell.
- Avoid listing PowerShell before Azure CLI, or alternate the order to avoid perceived preference.
- Add a note or section confirming that all instructions are applicable on Linux, macOS, and Windows, and highlight any platform-specific considerations.
- If any screenshots or step-by-step guides are included elsewhere, ensure they are not exclusively from Windows environments.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/howto-use-break-glass-access.md
...rticles/operator-nexus/howto-use-break-glass-access.md
High Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Windows Tools
Missing Linux Example
Summary
The documentation demonstrates a Windows bias by prioritizing Windows-specific instructions and tools. PowerShell commands and Windows-specific setup steps (such as enabling long paths via the registry) are provided explicitly, while equivalent Linux instructions are missing or only mentioned in passing. The prerequisites and setup sections mention both Windows and Linux, but actionable steps and troubleshooting are Windows-centric, leaving Linux users without clear guidance for several steps.
Recommendations
- For every Windows-specific step (e.g., enabling long paths, PowerShell commands), provide equivalent Linux instructions or explicitly state if not required on Linux.
- Include Linux bash command examples for all CLI operations, especially for SSH key generation and device access.
- Clarify any OS-specific requirements or differences (e.g., whether long path support is an issue on Linux).
- If a tool (like Yubico Key Manager) is required, provide download and installation instructions for both Windows and Linux.
- Ensure that all code snippets and setup steps are presented for both platforms, or clearly indicate when a step is OS-specific.
- Consider restructuring the documentation to present Windows and Linux instructions in parallel, rather than leading with Windows.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/includes/kubernetes-cluster/quickstart-cleanup-powershell.md
...es/kubernetes-cluster/quickstart-cleanup-powershell.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Missing Linux Example
Windows Tools
Summary
The documentation provides only an Azure PowerShell example (Remove-AzResourceGroup) for deleting the resource group, with no equivalent examples for Linux users (such as Azure CLI or Bash). This creates a bias toward Windows/PowerShell users and omits guidance for those on Linux or preferring cross-platform tools.
Recommendations
- Add an Azure CLI example (e.g., az group delete --name myResourceGroup) alongside the PowerShell example.
- Include Bash or shell script examples where appropriate.
- Present both PowerShell and CLI examples in parallel tabs or sections to ensure parity.
- Explicitly mention that the instructions apply to all platforms, or clarify platform-specific differences if any.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/includes/kubernetes-cluster/quickstart-cluster-connect-powershell.md
...netes-cluster/quickstart-cluster-connect-powershell.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Windows Tools
Summary
The documentation page exclusively references a PowerShell-based include file (cluster-connect-powershell.md) for cluster connection instructions, suggesting a strong Windows and PowerShell bias. There are no Linux or cross-platform CLI examples, and Windows tooling is implicitly prioritized.
Recommendations
- Provide equivalent Linux/bash examples alongside PowerShell instructions.
- Reference or include a cross-platform CLI (e.g., Azure CLI, kubectl) for cluster connection steps.
- Ensure that documentation does not assume the use of Windows or PowerShell as the default environment.
- Add explicit sections or links for Linux/macOS users to improve accessibility and parity.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/includes/kubernetes-cluster/cluster-connect-powershell.md
...ludes/kubernetes-cluster/cluster-connect-powershell.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Windows Tools
Summary
The documentation page demonstrates a strong Windows bias by exclusively providing Azure PowerShell examples for cluster setup and connection, without offering equivalent Azure CLI or Bash commands commonly used on Linux/macOS. The instructions and variable setting patterns are tailored to PowerShell, and there is no mention of Linux shell environments or cross-platform alternatives.
Recommendations
- Provide parallel Azure CLI/Bash examples for each PowerShell command, especially for setting variables and connecting to the cluster.
- Explicitly mention that both Windows and Linux/macOS are supported, and clarify which tools/commands are cross-platform.
- Reorder or present examples side-by-side to avoid prioritizing Windows/PowerShell over Linux/Bash.
- Include troubleshooting notes relevant to Linux environments, such as differences in authentication or environment variable handling.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/includes/kubernetes-cluster/quickstart-prerequisite-powershell.md
...bernetes-cluster/quickstart-prerequisite-powershell.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Missing Linux Example
Windows First
Summary
The documentation page demonstrates a strong bias toward Windows and PowerShell usage. All command-line examples use Azure PowerShell cmdlets, and there are no equivalent Azure CLI (bash-friendly) or native Linux shell examples. The instructions and tooling references (e.g., Az PowerShell module, Connect-AzAccount, Set-AzContext, New-AzResourceGroup) are all PowerShell-centric, with no mention of Azure CLI or Linux-native workflows. Even when mentioning Bash, it is only in the context of Azure Cloud Shell, which can run PowerShell as well.
Recommendations
- Provide equivalent Azure CLI (az) command examples for all PowerShell cmdlets shown, especially for resource group creation and subscription context.
- Explicitly mention that users can use either PowerShell or Bash in Azure Cloud Shell, and link to both PowerShell and Azure CLI quickstarts.
- Add installation and authentication instructions for Azure CLI for users running Linux or macOS locally.
- Ensure that Linux and cross-platform workflows are given equal prominence, ideally presenting both PowerShell and CLI examples side-by-side or allowing the user to select their preferred shell.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/includes/kubernetes-cluster/quickstart-review-deployment-powershell.md
...tes-cluster/quickstart-review-deployment-powershell.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Missing Linux Example
Windows Tools
Windows First
Summary
The documentation exclusively provides Azure PowerShell commands for resource management, with no mention of Azure CLI or Bash equivalents. PowerShell is primarily associated with Windows environments, and its exclusive use may disadvantage Linux or cross-platform users. The Azure portal is mentioned, but all command-line examples are Windows-centric.
Recommendations
- Provide equivalent Azure CLI (az) commands alongside PowerShell examples to ensure Linux and macOS users have clear guidance.
- Explicitly mention that PowerShell commands can be run cross-platform, or clarify if there are any platform-specific considerations.
- Consider presenting Azure CLI examples first or in parallel with PowerShell to avoid Windows-first bias.
- Add a note or section for Linux/macOS users, highlighting any differences or additional steps required.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/includes/virtual-machine/quickstart-cleanup-ps.md
...exus/includes/virtual-machine/quickstart-cleanup-ps.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Missing Linux Example
Windows Tools
Summary
The documentation provides only an Azure PowerShell example (Remove-AzResourceGroup) for deleting a resource group, with no equivalent example for Linux users (e.g., Azure CLI or Bash). This demonstrates a bias towards Windows tooling and omits cross-platform guidance.
Recommendations
- Add an Azure CLI example (e.g., az group delete --name myResourceGroup) alongside the PowerShell example.
- Include Bash or shell script examples where appropriate.
- Present both Windows and Linux commands in parallel tabs or sections to ensure parity.
- Explicitly mention that the operation can be performed from any platform using Azure CLI, not just PowerShell.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/includes/virtual-machine/quickstart-review-deployment-ps.md
...des/virtual-machine/quickstart-review-deployment-ps.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Missing Linux Example
Windows Tools
Windows First
Summary
The documentation page exclusively provides an Azure PowerShell example for viewing resources, with no mention of Linux-friendly tools such as Azure CLI, Bash, or cross-platform alternatives. The instructions and tooling are Windows-centric, and there is no guidance for users on Linux or macOS platforms.
Recommendations
- Add equivalent Azure CLI (az) examples alongside PowerShell commands, as Azure CLI is cross-platform and widely used on Linux.
- Explicitly mention that the instructions apply to both Windows and Linux, or provide tabs for both environments.
- Include Bash or shell script examples where appropriate, or at least note how Linux/macOS users can achieve the same result.
- Avoid assuming PowerShell as the default or primary tool; present CLI and PowerShell examples in parallel or with equal prominence.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/includes/kubernetes-cluster/quickstart-review-nodepool-powershell.md
...netes-cluster/quickstart-review-nodepool-powershell.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Missing Linux Example
Windows Tools
Summary
The documentation provides only an Azure PowerShell example for managing agent pools, with no equivalent example for Linux users (e.g., Azure CLI or Bash). The exclusive use of PowerShell and the absence of cross-platform command examples indicate a Windows bias.
Recommendations
- Add equivalent Azure CLI (az) command examples for managing agent pools, suitable for Linux/macOS users.
- Include Bash shell output examples alongside PowerShell.
- Explicitly mention cross-platform options and tools where possible, ensuring parity in instructions for both Windows and Linux environments.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/includes/virtual-machine/quickstart-prereq-ps.md
...nexus/includes/virtual-machine/quickstart-prereq-ps.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Missing Linux Example
Windows First
Summary
The documentation page exclusively uses PowerShell commands and references, with no mention of Bash, Azure CLI, or Linux-native tooling. All examples and instructions are centered around PowerShell and the Az PowerShell module, which are more familiar to Windows users. There are no Linux or cross-platform command examples, and the documentation does not acknowledge alternative environments or tools.
Recommendations
- Provide equivalent Azure CLI (az) command examples alongside PowerShell examples, as Azure CLI is cross-platform and commonly used on Linux.
- Mention and link to Bash or shell scripting options for Linux users, especially in the context of Azure Cloud Shell.
- Reorder or parallelize instructions so that Linux and Windows users are equally addressed (e.g., 'If you are using PowerShell, ... If you are using Azure CLI, ...').
- Clarify that Azure Cloud Shell supports both Bash and PowerShell, and provide links to both quickstarts.
- Avoid assuming PowerShell as the default environment; explicitly state that users can choose their preferred shell.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/quickstarts-tenant-workload-prerequisites.md
...tor-nexus/quickstarts-tenant-workload-prerequisites.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation consistently provides both Azure CLI and Azure PowerShell examples for all operations, but does not include any Linux shell or Bash-native examples beyond Azure CLI. PowerShell is featured equally alongside CLI, and in some cases, the PowerShell example is more verbose or appears first in the tab order. There are no Linux-specific tools, patterns, or troubleshooting steps, and no mention of Linux-native scripting or automation. The only Linux-relevant content is the brief section on setting HTTPS_PROXY environment variables, but this is generic and not tailored to Linux distributions or shell environments.
Recommendations
- Add explicit Bash/Linux shell examples for common tasks, especially where Azure CLI is used, to show how commands can be integrated into Linux scripts.
- Clarify that Azure CLI commands are cross-platform and can be run on Linux, macOS, and Windows, and provide any Linux-specific prerequisites if needed.
- Include troubleshooting tips or common issues for Linux users, such as file permissions, environment variable persistence, or package installation.
- If PowerShell is included, consider also providing Bash equivalents for scripting scenarios, especially for tasks like manipulating JSON output or chaining commands.
- Where environment variables are set, provide examples for both Bash (Linux/macOS) and PowerShell (Windows) shells, including how to persist these variables across sessions.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/concepts-network-fabric-read-only-commands.md
...or-nexus/concepts-network-fabric-read-only-commands.md
Medium Priority
View Details →
Detected Bias Types
Missing Linux Example
Windows First
Summary
The documentation exclusively provides Azure CLI examples and does not mention or provide examples for Linux or macOS environments, nor does it address platform-specific considerations. There is an implicit Windows bias in the troubleshooting workflow (e.g., opening a Microsoft support ticket, referencing Azure CLI without clarifying cross-platform compatibility), and no mention of Linux-native tools or shell environments. The documentation assumes the user is familiar with Azure CLI, which is available cross-platform, but does not explicitly demonstrate or acknowledge usage on Linux or macOS, nor does it provide Bash or shell script examples.
Recommendations
- Explicitly state that Azure CLI commands work on Windows, Linux, and macOS, and provide example commands in both Windows (cmd/PowerShell) and Linux/macOS (Bash/zsh) shell formats where relevant.
- Include notes or sections on installing and using Azure CLI on Linux and macOS, with links to official installation guides.
- If any output handling (such as downloading blobs or parsing JSON) is required, provide examples using Linux-native tools (e.g., curl, jq, wget) in addition to any Windows tools.
- Clarify that the troubleshooting steps and commands are platform-agnostic, or call out any platform-specific differences if they exist.
- Add troubleshooting tips or common issues for Linux/macOS users, such as permissions, environment variables, or shell syntax differences.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/howto-service-principal-rotation.md
...les/operator-nexus/howto-service-principal-rotation.md
Medium Priority
View Details →
Detected Bias Types
Missing Linux Example
Windows First
Summary
The documentation exclusively provides Azure CLI examples, which are cross-platform, but it lacks any mention of Linux-specific considerations or examples. There is no explicit Windows bias in terms of PowerShell or Windows-only tools, but the absence of any Linux shell (bash) examples or notes about Linux environments may implicitly favor Windows users, especially since Azure documentation often defaults to Windows-first perspectives.
Recommendations
- Explicitly state that the Azure CLI commands work on both Windows and Linux, and provide example shell environments (e.g., Bash for Linux, Command Prompt/PowerShell for Windows) where appropriate.
- Include notes or troubleshooting tips relevant to Linux users, such as file permission considerations or environment variable handling.
- If there are any platform-specific differences in command usage or output, document them clearly.
- Consider providing example commands in both Bash and PowerShell syntax if relevant, or clarify that the commands are identical across platforms.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/azure-operator-nexus-faq.md
...in/articles/operator-nexus/azure-operator-nexus-faq.md
Medium Priority
View Details →
Detected Bias Types
Missing Linux Example
Windows Tools
Summary
The documentation does not provide explicit Windows or PowerShell command examples, but it also lacks any Linux-specific examples, commands, or tooling references. The only OS mentioned for bare metal is 'Microsoft Azure Linux (CBL Mariner)', and all operational guidance is centered on Azure-native tools (Azure CLI, APIs, ARM templates, Bicep), which are cross-platform but not specifically Linux-oriented. There is no mention of Linux shell commands, Linux package management, or Linux-native tooling, and no parity examples for Linux users. The documentation assumes use of Azure tools and does not address Linux-specific workflows or troubleshooting.
Recommendations
- Include Linux shell (bash) command examples alongside Azure CLI usage, especially for common operational tasks.
- Explicitly mention cross-platform compatibility of Azure CLI and provide installation instructions for Linux.
- Where relevant, provide Linux-native troubleshooting steps or references (e.g., journalctl, systemctl for CBL Mariner).
- Clarify any differences in workflow or experience for Linux users, especially when interacting with on-premises components.
- Add examples or references for integrating with popular Linux monitoring/logging tools if possible.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/concepts-network-fabric-read-write-commands.md
...r-nexus/concepts-network-fabric-read-write-commands.md
Medium Priority
View Details →
Detected Bias Types
Windows Tools
Windows First
Summary
The documentation page demonstrates a subtle Windows bias, primarily through the use of Azure CLI output and telemetry examples that reference Windows file paths (e.g., 'C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\python.exe'), and by showing CLI debug output that is specific to Windows environments. There are no explicit PowerShell examples, but the debug and telemetry process outputs are Windows-centric. There are no Linux-specific examples or notes, and the documentation does not clarify cross-platform differences or provide Linux/macOS-specific troubleshooting or output samples.
Recommendations
- Provide example debug/telemetry outputs from both Windows and Linux environments, or use platform-agnostic output where possible.
- Add a note clarifying that Azure CLI is cross-platform and that command syntax is the same on Linux/macOS, but debug output paths may differ.
- Include at least one example of running the Azure CLI commands on Linux/macOS, possibly showing typical output or file paths (e.g., '/usr/bin/python3', '~/.azure').
- Avoid hardcoding Windows-style paths in documentation unless specifically discussing Windows; use variables or mention both styles (e.g., 'C:\... or ~/.azure').
- If there are any platform-specific caveats (such as newline handling in --rw-command), explicitly document them.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/howto-bare-metal-best-practices.md
...cles/operator-nexus/howto-bare-metal-best-practices.md
Medium Priority
View Details →
Detected Bias Types
Windows Tools
Missing Linux Example
Summary
The documentation demonstrates a bias toward Windows-centric tooling and patterns. It references and provides examples for iDRAC (a Dell BMC interface commonly managed via Windows tools), and the use of racadm commands, but does not provide equivalent Linux-native command-line examples or mention Linux tools for BMC management. There are no PowerShell-specific commands, but the absence of Linux-specific instructions or examples (such as ipmitool, Redfish CLI, or Linux shell commands) for BMC or hardware management is notable. All command-line examples are shown using Azure CLI, which is cross-platform, but the BMC management focus is on iDRAC/racadm, with no mention of alternatives more common in Linux environments.
Recommendations
- Add Linux-native examples for BMC management, such as using ipmitool or Redfish CLI, alongside or instead of racadm/iDRAC instructions.
- Explicitly mention that the Azure CLI commands are cross-platform and can be run on both Windows and Linux.
- Where BMC management is discussed, note alternative BMC interfaces (e.g., HPE iLO, Supermicro IPMI) and provide generic or Linux-friendly instructions.
- If referencing vendor-specific tools (like racadm), clarify platform compatibility and, where possible, provide installation or usage steps for Linux.
- Include troubleshooting or validation steps that use standard Linux utilities (e.g., systemctl, journalctl, dmesg) where appropriate.
Operator Nexus
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/operator-nexus/howto-use-commit-workflow-v2.md
...rticles/operator-nexus/howto-use-commit-workflow-v2.md
Medium Priority
View Details →
Detected Bias Types
Missing Linux Example
Windows First
Summary
The documentation exclusively provides Azure CLI examples and does not mention or provide examples for Linux-specific shells or tools. There is no explicit Windows bias in terms of PowerShell or Windows-only tools, but the absence of any mention of Linux/Unix shell environments, file paths, or platform-specific considerations may implicitly favor Windows users or those using Azure CLI on Windows. The documentation does not clarify cross-platform compatibility or provide parity examples for Linux users.
Recommendations
- Explicitly state that all Azure CLI commands are cross-platform and can be run on Windows, Linux, and macOS.
- Where relevant, provide example commands or notes for both Windows (CMD/PowerShell) and Linux/macOS (Bash) environments, especially for any file path or environment variable usage.
- Add a section or note about installing and using Azure CLI on Linux, including any prerequisites or differences in command usage.
- If there are any platform-specific behaviors (e.g., storage account URL formats, CLI output differences), document these clearly.
- Ensure that documentation language and examples are inclusive of both Windows and Linux users, avoiding assumptions about the user's operating system.