Backup
755
Total Pages
562
Linux-Friendly Pages
193
Pages with Bias
25.6%
Bias Rate
Bias Trend Over Time
Pages with Bias Issues
520 issues found
Showing 426-450 of 520 flagged pages
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation provides detailed instructions for the Azure portal and Azure PowerShell, with PowerShell examples and cmdlets shown in full. There are no CLI (az), Bash, or Linux/macOS-specific instructions or examples. PowerShell is a Windows-centric tool, and its usage is presented before any mention of cross-platform alternatives. REST API is mentioned but not demonstrated with examples. This creates friction for Linux/macOS users who typically use Bash, Azure CLI, or REST directly.
Recommendations
- Add equivalent Azure CLI (az) commands for all PowerShell operations, including deleting, undeleting, and resuming backup protection.
- Provide Bash script examples for Linux/macOS users.
- Explicitly mention that PowerShell Core is cross-platform, but clarify if Windows PowerShell is required or if all cmdlets work on Linux/macOS.
- Include REST API example requests and responses inline, not just as links.
- Present CLI and Bash examples before or alongside PowerShell examples to avoid Windows-first bias.
Create Pull Request
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Missing Linux Example
Summary
The documentation page demonstrates a Windows bias by referencing PowerShell scripts for key troubleshooting tasks (such as finding Recovery Services vaults and undeleting file shares) without providing equivalent Bash/Azure CLI examples for Linux/macOS users. The scripts are linked as 'backup-powershell-script-find-recovery-services-vault.md' and 'backup-powershell-script-undelete-file-share.md', and the instructions explicitly mention using these scripts or the 'Files portal', which is more familiar to Windows users. There are no Linux-specific or cross-platform CLI alternatives mentioned, and no parity guidance for non-Windows environments.
Recommendations
- Provide equivalent Azure CLI or Bash script examples alongside PowerShell scripts for all referenced troubleshooting tasks.
- Explicitly mention that all tasks can be performed using Azure CLI on Linux/macOS, and link to relevant documentation.
- Add notes or sections for Linux/macOS users, clarifying how to perform each step without relying on Windows tools.
- Ensure that script links are labeled with their platform (e.g., 'PowerShell (Windows)', 'Bash (Linux/macOS)').
Backup
Accidental Delete Protection for Azure Files
...b/main/articles/backup/soft-delete-azure-file-share.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Missing Linux Example
Summary
The documentation references an 'Undelete File Share Script' that is a PowerShell script, and does not mention or provide equivalent CLI or Bash examples for Linux/macOS users. The instructions and linked scripts/tools are Windows-centric, with no guidance for Linux users on how to perform undelete or related operations outside of the Azure Portal. There is no mention of Azure CLI or REST API alternatives, and the scripting example is exclusively for PowerShell.
Recommendations
- Provide Azure CLI and Bash script examples for undeleting file shares and other operations, alongside PowerShell.
- Explicitly mention cross-platform tools (e.g., Azure CLI, REST API) and link to their documentation.
- Clarify which steps can be performed from any OS via the Azure Portal, and which require platform-specific scripts.
- Add a section or note for Linux/macOS users on how to perform these tasks without PowerShell.
Backup
Tutorial - Back up Azure Database for PostgreSQL server
...lob/main/articles/backup/tutorial-postgresql-backup.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation demonstrates a Windows bias primarily through the repeated use of PowerShell scripts for privilege assignment and the lack of explicit Linux/macOS command-line examples. PowerShell is referenced as the default method for granting database privileges, with alternatives like PG admin or PSQL mentioned only as secondary options. There are no step-by-step instructions or examples for Linux/macOS users, and the documentation assumes familiarity with Windows-centric tools and workflows.
Recommendations
- Provide explicit Linux/macOS command-line examples using psql for privilege assignment, alongside PowerShell examples.
- Include instructions for using native PostgreSQL tools (psql, pgAdmin) on Linux/macOS for all steps where PowerShell is referenced.
- Clarify that PowerShell is not required and offer parity in walkthroughs for Linux/macOS environments.
- Add screenshots or terminal output examples for Linux/macOS workflows.
- Reorder examples so that platform-neutral or Linux/macOS instructions are presented before or alongside Windows/PowerShell methods.
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation page presents three pivots: Azure portal, PowerShell, and CLI. The PowerShell section is extensive and detailed, with step-by-step instructions and sample scripts, reflecting a strong Windows/PowerShell orientation. The CLI section is present and covers Linux/macOS-compatible workflows, but is less detailed and sometimes refers to PowerShell or portal for further steps. The ordering of pivots and examples often places Windows/PowerShell first, with more screenshots and guidance for those environments.
Recommendations
- Expand the CLI section to match the depth and clarity of the PowerShell section, including more step-by-step examples, troubleshooting, and sample scripts.
- Add explicit notes and guidance for Linux/macOS users, especially where PowerShell is referenced as a prerequisite or primary tool.
- Ensure that CLI examples are shown before or alongside PowerShell examples, and that all workflows are equally documented for both platforms.
- Where screenshots are used, include CLI output examples or Linux/macOS-specific visuals.
- Review 'Next steps' and cross-references to ensure CLI parity and avoid defaulting to PowerShell for advanced tasks.
Backup
Support matrix for Azure Elastic SAN Backup (preview)
...cles/backup/azure-elastic-san-backup-support-matrix.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation page exclusively references the Azure portal for backup configuration, restore, and management, without mentioning or providing examples for command-line tools such as Azure CLI, PowerShell, or REST API. While this avoids explicit Windows tool bias, it implicitly favors GUI-based workflows, which are more commonly associated with Windows environments. There is no mention of Linux-specific tools, CLI instructions, or cross-platform automation patterns, resulting in a lack of parity for Linux users who may prefer or require command-line or scriptable interfaces.
Recommendations
- Add examples and instructions for configuring, restoring, and managing Elastic SAN backups using Azure CLI, which is cross-platform and widely used on Linux.
- Include PowerShell examples for parity, but ensure CLI examples are presented first or alongside PowerShell to avoid Windows-first bias.
- Reference REST API documentation for users who wish to automate backup operations in a platform-agnostic way.
- Explicitly state that all operations can be performed via CLI and API, not just the Azure portal, and link to relevant documentation.
- Consider adding a section comparing portal, CLI, and API workflows, highlighting cross-platform options.
Backup
Integrate Microsoft Defender's ransomware alerts to protect Azure Backup recovery points
...up-azure-integrate-microsoft-defender-using-logic-apps.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation focuses exclusively on Azure Virtual Machines, with implicit emphasis on Windows environments. There are no examples, instructions, or notes regarding Linux VMs, Linux backup agents, or Linux-specific security considerations. All workflow steps, permissions, and integration points assume Windows-centric tools and services (e.g., Office 365 for email alerts, Microsoft Defender for Cloud, Azure Logic Apps) without mentioning Linux alternatives or compatibility. There is no guidance for users managing Linux VMs, nor any mention of Linux-specific ransomware detection or backup protection nuances.
Recommendations
- Explicitly state whether the solution supports Linux VMs and, if so, provide Linux-specific instructions or caveats.
- Include examples or screenshots demonstrating the integration process for Linux-based Azure VMs.
- Mention any differences in ransomware detection or backup protection for Linux VMs compared to Windows VMs.
- If Office 365 is not available or preferred, suggest alternative email alerting solutions compatible with Linux environments.
- Clarify whether permissions and roles (e.g., Backup Operator, Security Reader) apply equally to Linux VMs, and note any required configuration steps.
- Add troubleshooting or FAQ sections addressing common Linux VM scenarios (e.g., agent installation, alert compatibility, backup retention).
Backup
Manage SQL server databases in Azure VMs using Azure Backup via CLI
...ob/main/articles/backup/backup-azure-sql-manage-cli.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation page focuses exclusively on managing SQL Server databases in Azure VMs using the Azure CLI, but all examples and terminology assume SQL Server (a Windows-centric database) running on Azure VMs. There is no mention of Linux-based SQL Server deployments, nor are there any examples or notes about differences when running SQL Server on Linux VMs. All resource names and references (e.g., 'mssqlserver', 'testSQLVM') implicitly assume Windows environments, and there is no guidance for Linux users or parity in examples.
Recommendations
- Explicitly mention support for SQL Server on Linux VMs, if applicable, and clarify any differences in CLI usage or prerequisites.
- Provide example commands and output for SQL Server running on Linux VMs, including any differences in resource naming or container conventions.
- Add notes or sections highlighting Linux-specific considerations (e.g., authentication, file paths, service management) where relevant.
- Ensure terminology and examples do not assume Windows by default (e.g., use generic VM names, clarify when 'mssqlserver' applies to both platforms).
- Include links to documentation for deploying and managing SQL Server on Linux in Azure VMs.
Backup
Tutorial: Configure item-level backup for an Azure Kubernetes Service cluster
.../main/articles/backup/tutorial-configure-backup-aks.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation exclusively uses the Azure portal UI for configuration steps, which is platform-agnostic but implicitly Windows-centric due to the prevalence of Windows usage in portal screenshots and workflows. There are no command-line examples (e.g., Azure CLI, kubectl, Bash scripts) for Linux users, nor are Linux-specific tools or workflows mentioned. The 'Next step' section references the Azure CLI, but the main tutorial does not provide CLI or Linux-native instructions, resulting in a lack of parity for Linux users.
Recommendations
- Add Azure CLI and kubectl command examples for each configuration step, showing how to perform the same actions via command line on Linux.
- Include Bash script snippets for automating backup configuration on Linux systems.
- Provide screenshots or instructions for Linux desktop environments where relevant.
- Explicitly mention cross-platform compatibility and clarify that the portal steps apply equally to Linux and macOS users.
- Where possible, link to Linux-specific documentation or troubleshooting guides.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/azure-elastic-san-backup-support-matrix.md
...cles/backup/azure-elastic-san-backup-support-matrix.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation page exclusively references the Azure portal for configuration, restore, and management operations, without mentioning or providing examples for command-line tools such as Azure CLI, PowerShell, or REST API. While no explicit Windows tools are named, the lack of Linux-oriented instructions or parity (e.g., Azure CLI examples) suggests a subtle 'windows_first' and 'missing_linux_example' bias. This may disadvantage users who prefer or require Linux-based workflows or automation.
Recommendations
- Add instructions and examples for configuring, restoring, and managing Elastic SAN backup using Azure CLI, which is cross-platform and widely used on Linux.
- Include REST API references or examples for backup operations to support automation and platform neutrality.
- If PowerShell examples are provided elsewhere, ensure Azure CLI equivalents are given alongside.
- Explicitly mention cross-platform support and tools in the documentation introduction to signal parity.
- Consider adding a 'Tabs' UI for code examples (Portal, CLI, PowerShell, REST API) to improve accessibility for all users.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/azure-policy-configure-diagnostics.md
.../articles/backup/azure-policy-configure-diagnostics.md
Medium Priority
View Details →
Detected Bias Types
Missing Linux Example
Windows First
Summary
The documentation exclusively describes how to configure Vault Diagnostics settings using the Azure Portal GUI, with no mention of command-line or automation approaches such as Azure CLI, PowerShell, or scripting. There are no examples or guidance for Linux users or for using cross-platform tools. The workflow and screenshots are oriented toward the Azure Portal, which is commonly used on Windows, and there is no mention of Linux-specific considerations or parity in automation.
Recommendations
- Add Azure CLI examples for assigning the built-in policy and triggering remediation tasks, as Azure CLI is cross-platform and widely used on Linux.
- If PowerShell examples are provided in the future, ensure that equivalent Azure CLI or REST API examples are also included.
- Mention that all steps can be performed from any OS via the Azure Portal, but highlight automation options for Linux users.
- Include a section on automating policy assignments and remediation using scripts, with sample code for both Azure CLI and PowerShell.
- Explicitly state that the process is OS-agnostic when using the Azure Portal, and provide links to documentation for command-line automation.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/backup-azure-sql-manage-cli.md
...ob/main/articles/backup/backup-azure-sql-manage-cli.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation consistently references SQL Server databases and VM/container/resource names that imply Windows environments (e.g., 'mssqlserver', 'testSQLVM'), but does not explicitly mention or provide examples for Linux-based SQL Server VMs. There are no notes or examples addressing Linux-specific considerations, nor is there guidance for users running SQL Server on Linux VMs. All CLI examples use generic Azure CLI commands, but the context and naming conventions are Windows-centric.
Recommendations
- Add explicit guidance and examples for managing SQL Server databases on Linux-based Azure VMs, including any differences in resource naming, backup/restore processes, or prerequisites.
- Include a note clarifying that the Azure CLI commands work for both Windows and Linux SQL Server VMs, and highlight any platform-specific caveats.
- Provide example resource/container names for Linux SQL Server VMs, or show parallel examples for both Windows and Linux environments.
- Mention any Linux-specific requirements (e.g., SQL Server version, agent installation, permissions) for Azure Backup.
- Ensure that terminology and instructions are inclusive of both Windows and Linux SQL Server VM scenarios.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/backup-azure-vms-enhanced-policy.md
...in/articles/backup/backup-azure-vms-enhanced-policy.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation provides detailed PowerShell examples for configuring Enhanced backup policies, with step-by-step cmdlets and explanations. The PowerShell section is significantly more extensive than the Azure CLI section, which is more concise and lacks equivalent depth. There are no Linux-specific shell (bash) examples, nor is there mention of Linux tools or patterns. The order of presentation places PowerShell before CLI, suggesting a Windows-first approach.
Recommendations
- Add bash shell examples for Azure CLI commands, showing usage in typical Linux environments.
- Include notes or examples for scripting backup policy management on Linux, such as using cron jobs or shell scripts.
- Balance the depth of CLI and PowerShell sections, providing equally detailed walkthroughs for CLI users.
- Explicitly mention cross-platform compatibility of CLI commands, and clarify any differences in behavior or prerequisites between Windows and Linux.
- Consider reordering sections to present CLI before PowerShell, or interleave examples to emphasize parity.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/backup-rm-template-samples.md
...lob/main/articles/backup/backup-rm-template-samples.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation provides a comprehensive list of Azure Resource Manager and Bicep templates for backup scenarios but demonstrates a Windows bias by including a template specifically for deploying a Windows Server VM with backup enabled, while there are no equivalent examples for Linux VMs. Additionally, the SQL Server backup example is limited to SQL Gallery images, which are typically Windows-based, and there is no mention of Linux-based database backup scenarios.
Recommendations
- Add examples and templates for deploying and backing up Linux VMs, such as Ubuntu or CentOS, with Azure Backup enabled.
- Include backup scenarios for Linux-based databases (e.g., MySQL, PostgreSQL) running on Azure VMs.
- Ensure that for every Windows-specific template or example, there is a Linux equivalent provided or referenced.
- Explicitly mention cross-platform compatibility in descriptions, clarifying when templates are Windows-only or also support Linux.
- Consider adding a section summarizing OS support for each template to help users quickly identify applicability.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/offline-backup-overview.md
...s/blob/main/articles/backup/offline-backup-overview.md
Medium Priority
View Details →
Detected Bias Types
Windows Tools
Missing Linux Example
Summary
The documentation exclusively references Microsoft Azure Backup Server (MABS), System Center Data Protection Manager (DPM), and the MARS Agent—all Windows-based backup solutions. There are no examples, instructions, or mentions of Linux-based backup agents, tools, or workflows. The utilities and processes described (such as BitLocker encryption and the custom utility for disk preparation) are also Windows-centric, with no Linux equivalents or alternatives provided.
Recommendations
- Include information about Linux-based backup agents or supported third-party tools for Linux environments, if available.
- Provide explicit instructions or examples for performing offline backup from Linux servers, including any required utilities or scripts.
- Mention Linux-compatible disk encryption options (e.g., LUKS) if BitLocker is not available.
- Clarify platform support for each backup method (e.g., specify if only Windows servers are supported, or if Linux is also supported).
- If Linux is not supported, explicitly state this to set expectations for cross-platform users.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/blob-backup-configure-tutorial.md
...main/articles/backup/blob-backup-configure-tutorial.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation page shows a moderate Windows bias. In the 'Related content' section, Azure PowerShell is listed before Azure CLI, which is more cross-platform and Linux-friendly. There is also a dedicated link for restoring using Azure PowerShell, but no equivalent first-party Linux shell (e.g., Bash) or scripting examples are highlighted. The main tutorial focuses on the Azure Portal, which is platform-agnostic, but the supplementary content leans toward Windows tools.
Recommendations
- List Azure CLI examples before or alongside Azure PowerShell to avoid implying Windows-first workflows.
- Add explicit Bash or Linux shell examples where possible, especially in the 'Related content' section.
- Ensure that all command-line examples are provided for both Azure PowerShell and Azure CLI, with equal prominence.
- Consider including a note about cross-platform compatibility and linking to documentation that highlights Linux/macOS usage.
- If REST API usage is mentioned, provide sample curl commands or scripts that can be run from Linux environments.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/blob-backup-configure-quick.md
...ob/main/articles/backup/blob-backup-configure-quick.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation page demonstrates a Windows bias by listing Azure PowerShell as a restore method before Azure CLI, and by referencing PowerShell-specific instructions. There is no explicit mention of Linux-specific tools or examples, and the ordering suggests a preference for Windows-centric workflows.
Recommendations
- Ensure that Azure CLI examples are given equal prominence and ordering as Azure PowerShell, especially since CLI is cross-platform.
- Add explicit Linux usage notes or examples, such as running Azure CLI commands on Linux or macOS.
- Where PowerShell is referenced, clarify that it is available cross-platform, or provide Bash equivalents for Linux users.
- Review included content (such as blob-backup-azure-portal-configure-backup.md) for similar biases and update to include Linux-friendly instructions.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/manage-azure-file-share-rest-api.md
...in/articles/backup/manage-azure-file-share-rest-api.md
Medium Priority
View Details →
Detected Bias Types
Windows Tools
Windows First
Summary
The documentation page references Azure PowerShell and the Azure portal before Azure CLI, and includes HTTP response headers showing Microsoft-IIS and ASP.NET, which are Windows technologies. There are no explicit Linux shell examples or Linux-specific guidance, and the order of tool mentions puts Windows tools first.
Recommendations
- List Azure CLI before or alongside Azure PowerShell and the Azure portal when mentioning alternative management tools.
- Add explicit Linux shell (bash/curl) examples for REST API calls to demonstrate parity with Windows/PowerShell usage.
- Avoid including HTTP response headers that reference Windows-specific technologies (e.g., Microsoft-IIS, ASP.NET) unless relevant to the API consumer.
- Where possible, provide cross-platform command-line examples (e.g., both PowerShell and bash/curl) for common operations.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/quick-backup-aks.md
...ure-docs/blob/main/articles/backup/quick-backup-aks.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation exclusively uses the Azure portal UI for configuration steps and does not provide any command-line examples (such as Azure CLI, Bash, or PowerShell). While the Azure portal is cross-platform, the lack of CLI or script-based instructions can disadvantage Linux users or those who prefer automation. Additionally, the only explicit mention of command-line tools is in the 'Next step' section, where Azure CLI is listed after the portal, indicating a 'windows_first' or GUI-first bias. There are no Linux-specific considerations, nor are there examples using Bash or other Linux-native tools.
Recommendations
- Add step-by-step instructions for configuring AKS backup using Azure CLI, with example commands.
- Provide Bash script examples for common backup and restore operations.
- Ensure that CLI/script-based instructions are presented alongside or before portal-based steps to support automation and Linux users.
- Explicitly mention that the Azure portal is accessible from any OS, but highlight CLI alternatives for headless or automated environments.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/sap-hana-database-instance-troubleshoot.md
...cles/backup/sap-hana-database-instance-troubleshoot.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation refers exclusively to 'Azure VM' and does not specify or provide examples for either Windows or Linux platforms, despite SAP HANA being primarily a Linux workload. There are no command-line examples (e.g., Bash, PowerShell), but the absence of Linux-specific troubleshooting steps, tools, or filesystem commands (other than a brief mention of ext3/xfs) suggests a lack of Linux parity. The troubleshooting steps focus on Azure roles and permissions without addressing common Linux administrative tasks relevant to SAP HANA backup/restore scenarios.
Recommendations
- Explicitly state that SAP HANA is supported and typically deployed on Linux Azure VMs, and clarify if any steps differ for Linux vs. Windows.
- Add Linux-specific troubleshooting steps and examples, such as checking disk mounts, file system types, and using Bash commands to verify disk status.
- Include sample Bash commands for checking managed identity assignments, disk attachment, and file system compatibility.
- Reference Linux tools and patterns (e.g., systemctl for service status, lsblk for disk info) where appropriate.
- Ensure that any links to troubleshooting scripts or guides include Linux/Bash variants, not just PowerShell or Windows-centric scripts.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/security-overview.md
...re-docs/blob/main/articles/backup/security-overview.md
Medium Priority
View Details →
Detected Bias Types
Windows Tools
Missing Linux Example
Summary
The documentation page demonstrates a bias toward Windows environments by exclusively referencing the Microsoft Azure Recovery Services (MARS) agent for on-premises backups, which is a Windows-only tool. There are no examples, mentions, or guidance for Linux-based on-premises backup agents or scenarios. This omission may lead Linux users to feel unsupported or unclear about their backup options.
Recommendations
- Include information about Linux-based backup options for on-premises servers, such as Azure Backup Server (MABS), System Center Data Protection Manager (DPM), or third-party solutions supported by Azure.
- Provide explicit examples or references for backing up Linux servers, including any supported agents, scripts, or integration patterns.
- Clarify in the 'Security features to help protect hybrid backups' section how Linux servers can be protected, and if not supported, state this explicitly and link to alternative guidance.
- Ensure parity in documentation by mentioning both Windows and Linux scenarios where relevant, especially in hybrid backup contexts.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/tutorial-configure-backup-aks.md
.../main/articles/backup/tutorial-configure-backup-aks.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation exclusively uses the Azure portal UI for configuration steps and does not provide any command-line examples. While it mentions the Azure CLI in the 'Next step' section, all instructions and screenshots focus on the portal, which is more commonly used on Windows. There are no examples using Linux-native tools or shell commands, and no mention of how to perform these tasks using the CLI or automation scripts, which are preferred by many Linux users.
Recommendations
- Add parallel instructions and examples using the Azure CLI for each major configuration step, including relevant command snippets.
- Explicitly mention that all steps can be performed on Linux, macOS, or Windows, and provide guidance for non-portal users.
- Include at least one end-to-end example using shell scripting or YAML for automation, which is common in Linux environments.
- Balance screenshots and examples between the portal and CLI to ensure parity for Linux users.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/tutorial-cross-region-restore.md
.../main/articles/backup/tutorial-cross-region-restore.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation demonstrates a Windows-first bias by exclusively providing instructions for configuring and running Cross Region Restore using the Azure Portal UI, which is a graphical interface commonly associated with Windows workflows. There are no examples or guidance for performing these operations using Linux-friendly tools such as the Azure CLI, Bash scripts, or REST APIs. This omission makes it less accessible for Linux users or those who prefer command-line automation.
Recommendations
- Add equivalent step-by-step instructions using the Azure CLI for all major operations (enabling Cross Region Restore, viewing backup instances, restoring to secondary region).
- Include Bash script examples for automating Cross Region Restore tasks.
- Reference relevant REST API documentation and provide example API calls.
- Explicitly mention that all operations can be performed from Linux, macOS, or Windows environments using cross-platform tools.
- Ensure screenshots and UI references are supplemented with CLI or API output examples.
Backup
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/backup/tutorial-restore-disk.md
...ocs/blob/main/articles/backup/tutorial-restore-disk.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Reference
Summary
The documentation page is primarily focused on Azure CLI usage, which is cross-platform, and most examples are generic and applicable to both Windows and Linux environments. However, there is evidence of Windows bias: the only reference to alternative tooling is a link to a PowerShell-based tutorial, and the cross-zonal restore section links to a Windows VM creation article before mentioning general availability zones. There are no Linux-specific examples, nor is there mention of Linux-specific considerations or parity with Windows tooling.
Recommendations
- Add explicit Linux examples or considerations, such as restoring Linux VMs with specific configurations (e.g., SSH keys, OS disk types).
- Include references to Linux VM documentation (e.g., creating Linux VMs in availability zones) alongside or before Windows equivalents.
- If mentioning PowerShell, also mention Bash or other Linux-native scripting options for parity.
- Clarify that all CLI commands are cross-platform and provide notes on any OS-specific differences in restore behavior or prerequisites.
- Where links to Windows documentation are provided, ensure equivalent Linux documentation is also linked.
Low Priority
View Details →
Detected Bias Types
Windows First
Windows Tools
Summary
The Azure Backup glossary is generally cross-platform and workload-neutral, but there are minor signs of Windows bias: Windows tools (VSS, DPM, MABS, MARS agent) are referenced without equivalent Linux mentions, and the VSS (Windows Volume Shadow Copy Service) entry is included while Linux snapshot mechanisms are not. In the 'Application consistent backup' section, VSS is mentioned first, with Linux scripts as a parenthetical afterthought. However, most terms are platform-agnostic and the glossary covers Azure-native concepts.
Recommendations
- Add references or links to Linux snapshot/backup mechanisms (e.g., LVM snapshots, fsfreeze) where relevant, especially in sections like 'Application consistent backup' and 'File system consistent backup'.
- Where Windows tools (VSS, DPM, MABS, MARS agent) are mentioned, clarify their platform specificity and, if applicable, mention Linux alternatives or note that no equivalent exists.
- Consider adding a glossary entry for Linux backup concepts if Azure Backup supports them, or explicitly state when a term is Windows-only.
- In 'Application consistent backup', present Linux and Windows approaches with equal prominence, not as a parenthetical.
- For 'Snapshot', include a brief note about Linux snapshot technologies if relevant to Azure Backup workloads.