Storage Mover
25
Total Pages
9
Linux-Friendly Pages
16
Pages with Bias
64.0%
Bias Rate
Bias Trend Over Time
Pages with Bias Issues
85 issues found
Showing 26-50 of 85 flagged pages
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/job-definition-create.md
...b/main/articles/storage-mover/job-definition-create.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation provides detailed instructions and examples for creating and starting a migration job using the Azure portal and PowerShell. All command-line examples are exclusively in PowerShell, with no equivalent Linux shell (bash/CLI) examples. The documentation references Windows-centric tools and patterns (PowerShell cmdlets) and does not mention or demonstrate how to perform these tasks on Linux or using cross-platform Azure CLI. This creates a Windows bias, making it less accessible for Linux users.
Recommendations
- Add equivalent Azure CLI (az) examples for all PowerShell cmdlets shown, demonstrating how to create endpoints and job definitions from Linux/macOS.
- Explicitly mention cross-platform support and clarify which steps/tools work on Linux, macOS, and Windows.
- Include notes or sections on how Linux users can perform these tasks, including any prerequisites or differences (e.g., authentication, agent deployment).
- Where possible, provide bash script examples alongside PowerShell, especially for automation scenarios.
- Ensure that references to tools (e.g., PowerShell) are balanced with references to their Linux equivalents (e.g., Azure CLI, shell scripting).
Create Pull Request
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/status-code.md
...e-docs/blob/main/articles/storage-mover/status-code.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 referencing PowerShell cmdlets and Windows-specific naming conventions (e.g., 'con' as an invalid directory name), and by omitting Linux-specific troubleshooting steps, tools, or examples. The guidance for RBAC role assignment mentions PowerShell and APIs before other methods, and troubleshooting steps do not reference Linux tools or commands (such as shell commands for connectivity or permissions). The documentation also refers to SMB and file shares in a manner more familiar to Windows environments, without acknowledging NFS or Linux file system patterns.
Recommendations
- Include Linux-specific troubleshooting steps and examples, such as using shell commands (e.g., 'ls', 'mount', 'chmod', 'curl', 'openssl') for connectivity and permissions.
- Mention Linux equivalents for RBAC role assignment (e.g., Azure CLI commands) alongside or before PowerShell.
- Clarify that invalid directory names like 'con' are a Windows-specific restriction and provide Linux-specific naming guidance.
- Reference Linux file sharing protocols (e.g., NFS) and their troubleshooting where relevant.
- Provide examples of error investigation using Linux tools (e.g., checking logs, using 'systemctl' for agent status, etc.).
- Ensure that all instructions and troubleshooting steps are platform-agnostic or offer parity between Windows and Linux environments.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/service-prerequisites.md
...b/main/articles/storage-mover/service-prerequisites.md
High Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Windows Tools
Summary
The documentation demonstrates Windows bias by referencing Windows-centric hypervisors (Hyper-V, VMware) first when describing agent deployment, omitting explicit mention of Linux-based virtualization platforms (e.g., KVM, VirtualBox). There are no Linux-specific examples or instructions for agent deployment, registration, or management. The agent image is provided as a VHD (commonly used in Windows environments), with no mention of alternative formats (e.g., qcow2 for Linux/KVM). The documentation does not provide parity for Linux users in terms of setup, tooling, or workflow.
Recommendations
- Explicitly mention and provide instructions for deploying the agent VM on Linux-based hypervisors (e.g., KVM, VirtualBox, Proxmox).
- Offer the agent image in additional formats suitable for Linux virtualization (e.g., qcow2, ova).
- Include Linux-specific examples for agent registration and management (e.g., using bash, Linux CLI tools).
- Clarify that SSH-based registration works on both Windows and Linux hosts, and provide any necessary Linux-specific troubleshooting steps.
- Ensure that all prerequisites and workflows are documented for both Windows and Linux environments, with equal prominence.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/storage-mover-create.md
...ob/main/articles/storage-mover/storage-mover-create.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Windows Tools
Summary
The documentation provides detailed instructions and examples for both Azure CLI and Azure PowerShell, but the PowerShell section is more extensive, with additional setup steps, module installation, and resource provider registration guidance. PowerShell (a Windows-centric tool) is given a prominent and detailed treatment, and Windows-specific patterns (e.g., execution policy, PowerShell version checks) are included. There is no mention of Linux-specific shell usage (e.g., bash), nor are there examples tailored for Linux environments, such as shell variable syntax or installation steps for CLI on Linux. The CLI example uses variable syntax ($var) that is PowerShell-style, not bash/zsh, which may confuse Linux users.
Recommendations
- Add explicit bash/zsh examples for Azure CLI, using Linux shell variable syntax (e.g., storageMoverName="..."), and show commands as they would be run on Linux/macOS.
- Include installation instructions for Azure CLI on Linux and macOS, or link to them.
- Clarify that PowerShell instructions are primarily for Windows users, and provide parity for Linux/macOS users where possible.
- Avoid using PowerShell variable syntax in CLI examples; use cross-platform shell syntax or provide both.
- Mention any platform-specific requirements or differences (e.g., module installation, execution policy) for Linux/macOS users.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/job-definition-create.md
...b/main/articles/storage-mover/job-definition-create.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation provides detailed PowerShell examples for defining and starting a migration job, but does not include equivalent CLI or scripting examples for Linux environments (such as Bash, Azure CLI, or REST API). The use of PowerShell is presented as the primary programmatic method, and Windows-centric tools and patterns are referenced before any Linux alternatives (which are absent). This creates a bias toward Windows users and may hinder Linux users from easily following the instructions.
Recommendations
- Add equivalent examples using Azure CLI (az), Bash scripts, and/or REST API calls for defining endpoints and job definitions.
- Explicitly mention cross-platform support and clarify which steps/tools are available on Linux and macOS.
- Provide guidance or links for Linux users on installing and using Azure CLI and other relevant tools.
- Where PowerShell is used, note its availability on Linux and macOS, or suggest alternative approaches for those platforms.
- Ensure that screenshots and UI instructions are not Windows-specific, or supplement with Linux/macOS alternatives where relevant.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/agent-deploy.md
...-docs/blob/main/articles/storage-mover/agent-deploy.md
High Priority
View Details →
Detected Bias Types
Windows First
Windows Tools
Missing Linux Example
Summary
The documentation demonstrates a Windows bias by exclusively providing detailed instructions and screenshots for deploying the agent VM on Microsoft Hyper-V (a Windows technology), referencing Windows Server documentation, and mentioning Windows Hyper-V before VMware. There are no examples or instructions for deploying the agent on Linux-based virtualization platforms (such as KVM, VirtualBox, or Proxmox), nor any guidance for Linux users. The prerequisites and supported environments are limited to Windows Hyper-V and VMware, with no mention of Linux alternatives.
Recommendations
- Add explicit statements about Linux support status and plans, if any.
- If technically feasible, provide instructions for deploying the agent VM on popular Linux-based virtualization platforms (e.g., KVM, VirtualBox, Proxmox).
- Include Linux CLI examples and troubleshooting steps where applicable.
- Balance references to Windows tools with equivalent Linux tools or documentation.
- If Linux is not supported, clarify this early in the documentation and suggest workarounds or alternatives for Linux users.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/storage-mover-create.md
...ob/main/articles/storage-mover/storage-mover-create.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Windows Tools
Summary
The documentation provides detailed instructions for both Azure CLI and Azure PowerShell, but the PowerShell section is notably more extensive, with additional setup steps and troubleshooting advice. PowerShell is a Windows-centric tool, and its prominence, along with references to execution policy and module installation, suggests a Windows bias. There are no explicit Linux shell (bash) examples, nor is there mention of Linux-specific considerations, even though Azure CLI is cross-platform. The CLI example uses variable syntax ($var) that is PowerShell-style, not bash, which may confuse Linux users.
Recommendations
- Add explicit bash/Linux shell examples for Azure CLI, using Linux-style variable syntax (e.g., export storageMoverName="..."), and clarify cross-platform usage.
- Balance the detail level between PowerShell and CLI sections, ensuring Linux users receive equivalent troubleshooting/setup guidance.
- Mention that Azure CLI works natively on Linux/macOS and provide any OS-specific notes if needed.
- Avoid using PowerShell variable syntax in CLI examples; use syntax appropriate for the shell.
- If there are any platform-specific limitations or requirements, call them out clearly for both Windows and Linux users.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/bandwidth-management.md
...ob/main/articles/storage-mover/bandwidth-management.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation provides detailed instructions and examples for managing bandwidth schedules using Azure PowerShell, which is primarily associated with Windows environments. There are no equivalent CLI (az cli), Bash, or Linux-native examples, nor is there any mention of Linux tools or workflows for agent management. The only command-line automation guidance is Windows-centric, and PowerShell is presented as the default and only scripting option.
Recommendations
- Add equivalent examples using Azure CLI (az cli), which is cross-platform and commonly used on Linux.
- Include Bash script snippets for manipulating the JSON schedule, demonstrating how Linux users can automate agent configuration.
- Explicitly mention that PowerShell Core is available on Linux and macOS, and provide installation instructions or links.
- Provide guidance for managing agent schedules via REST API calls, with curl examples for Linux users.
- Ensure that screenshots and UI instructions do not assume Windows-only environments (e.g., referencing Outlook calendars or Windows-specific UI metaphors).
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/endpoint-manage.md
...cs/blob/main/articles/storage-mover/endpoint-manage.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Missing Linux Example
Windows Tools
Windows First
Summary
The documentation page demonstrates a Windows bias by exclusively providing PowerShell examples for endpoint management, referencing Windows tools and patterns (e.g., PowerShell, execution policy, resource naming conventions tied to Windows), and omitting equivalent Linux CLI or scripting examples (such as Azure CLI, Bash, or REST API usage). Windows/PowerShell instructions are presented as the only programmatic option, with no mention of Linux-native workflows or tools. Additionally, the narrative and examples often assume a Windows-centric environment, such as referencing NTFS file properties and Windows authentication concepts before Linux/NFS equivalents.
Recommendations
- Add Azure CLI examples for all endpoint management tasks, including creation, viewing, editing, and deletion, to provide parity for Linux users.
- Include Bash scripting examples and instructions for using the REST API directly, which are common on Linux systems.
- Explicitly mention Linux support and workflows in introductory sections, clarifying that all operations can be performed from Linux environments.
- Reference Linux-native authentication and file system concepts alongside Windows/NTFS, ensuring equal coverage and order.
- Review and update screenshots and UI references to ensure they do not assume a Windows environment (e.g., avoid showing only Windows-style paths or tools).
- Where PowerShell is referenced, provide equivalent commands for Bash/Azure CLI, and clarify cross-platform compatibility.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/project-manage.md
...ocs/blob/main/articles/storage-mover/project-manage.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Missing Linux Example
Windows First
Summary
The documentation page demonstrates a Windows bias by exclusively providing command-line examples using PowerShell and the Az PowerShell module, which are primarily Windows-centric tools. There are no examples or guidance for Linux users, such as using Azure CLI, Bash, or cross-platform scripting. The PowerShell examples are detailed and given equal prominence to the Azure Portal, but Linux-native tools and workflows are entirely absent. Additionally, installation instructions and prerequisites focus on PowerShell-specific requirements, further reinforcing the Windows-first approach.
Recommendations
- Add equivalent Azure CLI examples for all operations (create, view, edit, delete project) to support Linux and macOS users.
- Include Bash scripting samples where appropriate, demonstrating cross-platform automation.
- Mention that Azure CLI is available on Windows, Linux, and macOS, and provide installation instructions for non-Windows platforms.
- Clarify that PowerShell Core (pwsh) is cross-platform, but also provide CLI alternatives for users who prefer native Linux tools.
- Ensure that any prerequisites or environment setup steps include Linux/macOS instructions, not just PowerShell/Windows-specific guidance.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/service-prerequisites.md
...b/main/articles/storage-mover/service-prerequisites.md
High Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Windows Tools
Summary
The documentation page demonstrates a Windows bias by referencing Windows-centric virtualization platforms (Hyper-V, VMware) first and exclusively, omitting mention of Linux-based hypervisors (such as KVM or VirtualBox). There are no examples or instructions for deploying or managing the agent VM on Linux environments. The agent registration process is described generically, but the setup and deployment steps assume familiarity with Windows tools and patterns, with no Linux-specific guidance or parity.
Recommendations
- Include explicit instructions and examples for deploying the agent VM on Linux-based hypervisors (e.g., KVM, VirtualBox, Proxmox).
- Add Linux-specific prerequisites, such as required packages, shell commands, and configuration steps for agent deployment and registration.
- Provide parity in examples for Azure CLI and PowerShell, ensuring both are presented equally and with platform-specific notes where relevant.
- Reference Linux tools and patterns alongside Windows ones, and avoid assuming Windows as the default environment.
- Clarify any OS-specific requirements or limitations for the agent VM image (e.g., compatibility with Linux hosts, extraction and mounting procedures).
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/migration-basics.md
...s/blob/main/articles/storage-mover/migration-basics.md
High Priority
View Details →
Detected Bias Types
Windows Tools
Windows First
Missing Linux Example
Summary
The documentation page demonstrates mild Windows bias. While it generally discusses migration concepts in a platform-neutral manner, it references Windows-centric tools and patterns (such as NTFS permissions and Azure PowerShell) before mentioning cross-platform or Linux alternatives. Examples and terminology (e.g., NTFS, PowerShell) are Windows-first, and there are no explicit Linux-specific examples or instructions (e.g., using Bash, Linux ACLs, or Linux file systems).
Recommendations
- Include explicit Linux examples and instructions, such as using Bash or Linux CLI commands for Azure resource deployment.
- Mention Linux file system permissions (e.g., POSIX ACLs) alongside NTFS permissions when discussing file fidelity.
- List Azure CLI before or alongside Azure PowerShell when suggesting deployment tools, and clarify that both Windows and Linux users are supported.
- Add examples or references for migrating from Linux-based file shares (e.g., NFS on Linux servers) and handling Linux-specific metadata.
- Ensure terminology and examples are balanced between Windows and Linux environments throughout the documentation.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/status-code.md
...e-docs/blob/main/articles/storage-mover/status-code.md
High Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Windows Tools
Summary
The documentation demonstrates a Windows bias in several ways: it references PowerShell cmdlets and APIs before mentioning alternatives, omits Linux-specific troubleshooting steps or examples, and uses terminology and error examples (such as invalid Windows directory names like 'con') that are specific to Windows environments. There is no mention of Linux tools, commands, or patterns for troubleshooting, and the documentation does not provide parity for Linux users in terms of examples or guidance.
Recommendations
- Include Linux-specific troubleshooting steps and examples (e.g., using shell commands for network and permission checks).
- Mention Linux equivalents for PowerShell cmdlets and APIs, such as Azure CLI or REST API usage from bash.
- Add guidance for common Linux errors and patterns (e.g., file permissions, SELinux, systemd service status).
- Provide examples of mounting SMB shares and checking connectivity on Linux (e.g., using 'mount', 'smbclient', 'curl', etc.).
- Reference both Windows and Linux naming conventions and error cases, clarifying which apply to each OS.
- Ensure that RBAC assignment instructions include Azure CLI and portal steps, not just PowerShell.
- Add troubleshooting steps for agent installation and operation on Linux systems, including log locations and service management.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/project-manage.md
...ocs/blob/main/articles/storage-mover/project-manage.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Missing Linux Example
Windows First
Summary
The documentation page demonstrates a Windows bias by providing only Azure PowerShell examples for command-line operations, with no mention of Linux-native tools, Bash, or Azure CLI. All automation and scripting instructions use PowerShell cmdlets and installation steps, which are primarily Windows-centric. There are no Linux or cross-platform command-line examples, and PowerShell is presented as the default/only scripting option, despite Azure CLI being widely used on Linux and macOS.
Recommendations
- Add equivalent Azure CLI examples for all PowerShell cmdlets, showing how to create, view, edit, and delete Storage Mover projects using az commands.
- Include Bash shell scripting examples where appropriate, especially for variable assignment and command chaining.
- Explicitly state cross-platform support for Azure CLI and PowerShell, and clarify installation steps for Linux and macOS users.
- Reorder examples to present Azure CLI (cross-platform) before PowerShell, or provide both side-by-side.
- Mention that Azure PowerShell is available on Linux/macOS, but highlight Azure CLI as the more native choice for those platforms.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/troubleshooting.md
...cs/blob/main/articles/storage-mover/troubleshooting.md
High Priority
View Details →
Detected Bias Types
Windows First
Windows Tools
Missing Linux Example
Summary
The documentation page demonstrates Windows bias by referencing Windows tools and patterns first and exclusively. It mentions that a secure FTP client is installed on most typical Windows instances, and recommends WinRAR (a Windows tool) for extracting Zstandard archives, without mentioning Linux equivalents. There are no examples or instructions for Linux users, such as using native Linux tools (e.g., scp, sftp, tar, zstd), nor is there guidance for Linux environments, despite the agent logs referencing Linux-style commands and file structures.
Recommendations
- Include instructions and examples for Linux users, such as using scp or sftp to retrieve the support bundle.
- Recommend Linux-native tools for extracting Zstandard archives, such as the 'zstd' and 'tar' command-line utilities.
- Avoid assuming the host is Windows; provide parity for Linux and macOS hosts.
- List both Windows and Linux tools side-by-side when discussing prerequisites.
- Explicitly mention how to perform each step on Linux, including command syntax and package installation if needed.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/job-definition-create.md
...b/main/articles/storage-mover/job-definition-create.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Windows Tools
Summary
The documentation provides detailed instructions for defining a migration job using the Azure Portal and PowerShell, with all CLI-based examples using PowerShell cmdlets. There are no examples or references for Linux-native tools, Bash, or Azure CLI, and PowerShell is presented as the only scripting/automation option. This creates a Windows-centric experience, potentially excluding Linux users or those who prefer cross-platform tools.
Recommendations
- Add equivalent Azure CLI examples for all PowerShell cmdlets shown, ensuring Linux and macOS users can follow along without needing PowerShell.
- Explicitly mention that PowerShell examples are cross-platform if true, or clarify any Windows-specific requirements.
- Include Bash script examples or guidance for Linux environments where appropriate.
- Reference Linux-native tools or workflows (e.g., az CLI, shell scripting) alongside PowerShell, not just after or as an afterthought.
- Ensure that any screenshots or UI instructions do not assume a Windows environment (e.g., file paths, UI conventions).
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/bandwidth-management.md
...ob/main/articles/storage-mover/bandwidth-management.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Missing Linux Example
Windows Tools
Windows First
Summary
The documentation page demonstrates a significant Windows bias, particularly in the command-line and scripting sections. All automation and scripting examples are provided exclusively using PowerShell, a tool primarily associated with Windows environments (despite its cross-platform support, it is still less common on Linux). There are no CLI, Bash, or Linux-native command examples, nor is there mention of using the Azure CLI or REST API, which are more typical in Linux workflows. The prerequisite and walkthrough sections also reference patterns and tools familiar to Windows users (e.g., Outlook-style calendar, PowerShell, and Windows-centric terminology), with no Linux-first or cross-platform parity.
Recommendations
- Provide equivalent examples using Azure CLI (az), which is widely used on Linux and macOS, alongside PowerShell.
- Include Bash shell scripting examples for schedule management, or at least show how to use curl or other Linux-native tools to interact with the relevant Azure REST APIs.
- Explicitly mention that PowerShell Core is cross-platform, but clarify installation steps for Linux and macOS users.
- Balance screenshots and terminology to reference both Windows and Linux environments (e.g., compare Outlook calendar to common Linux calendar tools, or use more neutral language).
- Add a section or callout for Linux users, outlining any differences or additional steps required.
- Reference documentation for managing Storage Mover agents from Linux systems, if available.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/troubleshooting.md
...cs/blob/main/articles/storage-mover/troubleshooting.md
High Priority
View Details →
Detected Bias Types
Windows First
Windows Tools
Missing Linux Example
Summary
The documentation demonstrates a Windows bias by referencing Windows tools and patterns first or exclusively. It mentions that a secure FTP client is installed on most typical Windows instances, and recommends WinRAR (a Windows tool) for extracting Zstandard archives, without mentioning Linux equivalents. There are no explicit Linux command examples or tool recommendations, and the documentation assumes a Windows-centric environment for host operations.
Recommendations
- Explicitly mention and provide examples for both Windows and Linux environments when discussing prerequisites and tools (e.g., recommend FileZilla or lftp for Linux as secure FTP clients).
- Suggest Linux-native tools for extracting Zstandard archives, such as 'tar' with 'zstd' or the 'unzstd' command, alongside WinRAR.
- Include example commands for retrieving and extracting the support bundle on Linux hosts, not just Windows.
- Avoid language that assumes the user is on Windows (e.g., 'A secure FTP client is installed on most typical Windows instances') and instead provide parity for both platforms.
- Where screenshots or command snippets are shown, provide both Windows and Linux variants if the process differs.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/status-code.md
...e-docs/blob/main/articles/storage-mover/status-code.md
High Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation page demonstrates a mild Windows bias. It references PowerShell cmdlets and APIs for manual RBAC assignment, but does not mention or provide equivalent instructions for Linux users (such as Azure CLI or Bash). No Linux-specific tools or examples are provided, and the troubleshooting steps assume familiarity with Windows-centric patterns. There are no explicit Linux instructions or parity in command-line tooling.
Recommendations
- Include Azure CLI (az) command examples alongside or before PowerShell cmdlets for RBAC assignment and troubleshooting.
- Explicitly mention that all steps can be performed from Linux, macOS, or Windows, and provide Bash/CLI equivalents where possible.
- Add troubleshooting guidance for common Linux/NFS scenarios, not just SMB/Windows.
- Where APIs or SDKs are referenced, clarify that these are cross-platform and provide links or examples for both PowerShell and CLI.
- Review all troubleshooting steps to ensure they are not Windows-centric and are accessible to users on all platforms.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/project-manage.md
...ocs/blob/main/articles/storage-mover/project-manage.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Missing Linux Example
Windows Tools
Windows First
Summary
The documentation provides management instructions for Azure Storage Mover projects using the Azure Portal and PowerShell exclusively. All command-line examples use PowerShell cmdlets, with no mention of cross-platform CLI tools (such as Azure CLI) or Linux shell equivalents. Installation instructions and prerequisites are PowerShell-specific, and there are no Bash or Linux-native command examples. This creates a bias towards Windows users and environments.
Recommendations
- Add equivalent Azure CLI (az) examples for all PowerShell cmdlets, as Azure CLI is cross-platform and widely used on Linux and macOS.
- Include Bash shell script examples alongside PowerShell, especially for variable assignment and command execution.
- Explicitly mention that PowerShell Core is available on Linux and macOS, but clarify that Azure CLI is often preferred on those platforms.
- Reorder sections or provide tabs so that Azure CLI and Bash examples are presented alongside or before PowerShell, ensuring parity.
- Review installation instructions to include Azure CLI installation steps for Linux/macOS users.
- Avoid language or tool recommendations that assume a Windows environment unless absolutely necessary.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/bandwidth-management.md
...ob/main/articles/storage-mover/bandwidth-management.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation page demonstrates a Windows bias by providing only PowerShell-based CLI examples for configuring bandwidth schedules, with no mention of Linux-native tools, Bash, or cross-platform CLI alternatives. The PowerShell section is extensive and presented as the sole scripting/automation method, implying a preference for Windows environments. There are no Linux-specific instructions or parity in command-line guidance.
Recommendations
- Add equivalent Azure CLI (az) examples for all PowerShell commands, as Azure CLI is cross-platform and works natively on Linux, macOS, and Windows.
- Explicitly mention that the Storage Mover agent and its management tools are supported on Linux, if applicable, and provide any Linux-specific prerequisites or notes.
- Include Bash shell script examples for common tasks, or at least show how to use curl or az CLI to manipulate the bandwidth schedule JSON.
- Clarify whether the agent console (for timezone changes) is accessible and behaves identically on Linux and Windows deployments, and provide OS-specific instructions if there are differences.
- Review screenshots and UI instructions to ensure they are not overly tailored to a Windows/Outlook paradigm, or provide alternative references familiar to Linux users.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/endpoint-manage.md
...cs/blob/main/articles/storage-mover/endpoint-manage.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Missing Linux Example
Windows Tools
Summary
The documentation provides detailed instructions and code samples exclusively for Azure PowerShell, which is a Windows-centric tool, and does not include equivalent examples for Linux-native tools or CLI (such as Azure CLI or Bash scripts). There is no mention of Linux shell commands or cross-platform scripting options, and the only automation examples are in PowerShell. This creates a bias toward Windows users and may hinder Linux users from following the documentation effectively.
Recommendations
- Add equivalent Azure CLI (az) command examples for all PowerShell cmdlets, as Azure CLI is cross-platform and widely used on Linux.
- Include Bash shell script examples for common tasks, especially for endpoint creation, management, and deletion.
- Explicitly mention that PowerShell Core (v7+) is cross-platform, but also provide guidance for users who prefer native Linux tools.
- Where possible, provide REST API examples (using curl or similar tools) for advanced users who may want to automate tasks outside of PowerShell.
- Balance the order of examples: present Azure CLI or Bash examples before or alongside PowerShell to avoid the impression that Windows tools are the primary or only supported automation method.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/agent-deploy.md
...-docs/blob/main/articles/storage-mover/agent-deploy.md
High Priority
View Details →
Detected Bias Types
Windows First
Windows Tools
Missing Linux Example
Summary
The documentation demonstrates a Windows bias by focusing exclusively on Windows Hyper-V and VMware as supported virtualization platforms, with all step-by-step instructions and screenshots provided only for Hyper-V (a Windows technology). There is no mention of Linux-based virtualization solutions (such as KVM, VirtualBox, or Linux-native Hyper-V management), nor are there any Linux command-line examples or guidance for deploying or managing the agent from a Linux environment. The documentation also references Windows Server documentation and tools before mentioning VMware, and does not provide parity for Linux users.
Recommendations
- Explicitly state whether Linux-based virtualization platforms (e.g., KVM, VirtualBox) are supported or not, and if not, provide a roadmap or rationale.
- If the agent image is compatible with Linux-based hypervisors, add detailed, step-by-step instructions for deploying the agent using KVM/QEMU or VirtualBox on Linux hosts, including relevant command-line examples.
- Include Linux-specific networking guidance (e.g., how to create a bridge or virtual switch using Linux tools such as nmcli, brctl, or virsh).
- Provide parity in decommissioning and management instructions, including examples using Azure CLI from a Linux shell.
- If only Windows and VMware are supported, clarify this early and prominently, and consider providing alternative solutions or workarounds for Linux-only environments.
- Balance references to Windows Server documentation with links to VMware and, if possible, Linux virtualization documentation.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/job-definition-create.md
...b/main/articles/storage-mover/job-definition-create.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation provides detailed step-by-step instructions for creating and managing migration jobs using the Azure Portal and PowerShell, with all CLI-based examples exclusively using PowerShell cmdlets. There are no examples or references for performing these tasks using cross-platform tools such as Azure CLI, Bash, or Linux-native scripting. The PowerShell section assumes the user is familiar with PowerShell and does not mention Linux or macOS usage, nor does it provide equivalent commands for those environments. This creates a Windows-centric bias and may hinder Linux users from following the documentation effectively.
Recommendations
- Add equivalent Azure CLI examples for all PowerShell cmdlets shown, ensuring Linux and macOS users can follow along without needing PowerShell.
- Explicitly mention cross-platform compatibility where possible, and clarify if any features are Windows-only.
- Include Bash script examples or notes for Linux users, especially for common automation scenarios.
- Reorder or parallelize the documentation sections so that PowerShell and Azure CLI (or Bash) examples are presented side-by-side, rather than PowerShell-only.
- Reference any platform-specific prerequisites or differences (e.g., installation of Azure CLI on Linux) to ensure parity.
Storage Mover
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-mover/migration-basics.md
...s/blob/main/articles/storage-mover/migration-basics.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation page demonstrates a Windows bias by referencing Azure PowerShell before Azure CLI when listing deployment tools, and by not providing any explicit Linux or cross-platform examples or guidance. The mention of file permissions focuses on NTFS and ACLs, which are Windows-centric, without equivalent discussion of Linux file permissions or tools. There are no concrete examples or instructions for Linux users, and the documentation implicitly assumes a Windows environment.
Recommendations
- When listing deployment tools, mention Azure CLI before or alongside Azure PowerShell to avoid implying PowerShell is the primary or preferred method.
- Include explicit examples for both Windows (PowerShell) and Linux (Bash/Azure CLI) when demonstrating commands or migration steps.
- Discuss Linux file permission models (e.g., POSIX permissions) alongside NTFS/ACLs when talking about file metadata and fidelity.
- Reference Linux-compatible tools and workflows (such as rsync, NFS, or Linux SMB clients) where relevant.
- Add a section or callout for Linux users, highlighting any platform-specific considerations or steps.
- Ensure that screenshots, code snippets, and instructions are cross-platform or clearly indicate which OS they apply to.