Storage Discovery

15
Total Pages
12
Linux-Friendly Pages
3
Pages with Bias
20.0%
Bias Rate

Bias Trend Over Time

Pages with Bias Issues

12 issues found
Showing 1-12 of 12 flagged pages
Storage Discovery Create and manage an Azure Storage Discovery Workspace ...ob/main/articles/storage-discovery/create-workspace.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example
Summary
The documentation page demonstrates Windows bias by providing a detailed Azure PowerShell example before the Azure CLI example, and omitting any explicit Linux shell (bash/zsh) or scripting examples. The PowerShell section is more verbose and instructive, while the CLI section is brief and lacks contextual guidance. No Linux-specific considerations or parity checks are mentioned.
Recommendations
  • Add explicit bash/zsh examples for Linux users, including variable assignment and script context.
  • Ensure CLI instructions are as detailed and instructive as PowerShell, with step-by-step guidance and explanations.
  • Where PowerShell is mentioned, also mention cross-platform alternatives (e.g., Bash, Cloud Shell) and clarify platform compatibility.
  • Include notes on running Azure CLI in Linux environments, and highlight any differences or prerequisites.
  • Balance the order of examples so that CLI and PowerShell are presented with equal prominence, or alternate which comes first.
GitHub Create Pull Request
Storage Discovery Planning for an Azure Storage Discovery deployment ...main/articles/storage-discovery/deployment-planning.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation page demonstrates Windows bias by listing Azure PowerShell as a primary method for resource provider registration, mentioning it before Azure CLI (which is more cross-platform and Linux-friendly). There are no explicit Linux or Bash examples, nor references to Linux-specific tooling or workflows. The guidance assumes familiarity with Windows-centric tools (PowerShell, Azure portal) and does not provide parity for Linux users.
Recommendations
  • Provide explicit Bash/Azure CLI command examples for all actions currently described with PowerShell.
  • When listing management options, mention Azure CLI before or alongside PowerShell to avoid Windows-first ordering.
  • Include notes or sections for Linux/macOS users, clarifying that all steps can be performed cross-platform and providing relevant command-line examples.
  • Avoid assuming the Azure portal or PowerShell as the default management interface; highlight CLI and automation options equally.
GitHub Create Pull Request
Storage Discovery Planning for an Azure Storage Discovery deployment ...main/articles/storage-discovery/deployment-planning.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation page demonstrates Windows bias by listing Azure PowerShell as a primary method for resource provider registration before Azure CLI, and by referencing PowerShell specifically in tips and instructions. There are no explicit Linux-specific examples or mentions of Linux tools, and the ordering and language imply a preference for Windows-centric workflows.
Recommendations
  • Provide explicit Linux and macOS instructions and examples alongside Windows/PowerShell ones.
  • List Azure CLI before or alongside PowerShell when describing command-line options, as CLI is cross-platform.
  • Add notes clarifying that all steps can be performed on Linux/macOS using Azure CLI.
  • Include screenshots or walkthroughs for Linux environments where relevant.
  • Avoid language that implies PowerShell is the default or preferred method unless justified by functionality.
GitHub Create Pull Request
Storage Discovery Create and manage an Azure Storage Discovery Workspace ...ob/main/articles/storage-discovery/create-workspace.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example
Summary
The documentation page demonstrates Windows bias by providing a detailed Azure PowerShell example before the Azure CLI example, with no mention of Linux-specific tools or shell environments. The PowerShell script is more verbose and explanatory, while the CLI example is brief and lacks context. There are no Bash or Linux shell examples, nor any discussion of Linux-specific considerations.
Recommendations
  • Provide Bash/Linux shell examples for Azure CLI usage, including variable assignment and script context.
  • Ensure CLI examples are as detailed and explanatory as PowerShell examples, including step-by-step instructions and variable usage.
  • Explicitly mention cross-platform compatibility for CLI commands and clarify that Azure CLI works on Linux, macOS, and Windows.
  • Consider adding a section or tab for Linux users, outlining any environment-specific setup or considerations.
  • Avoid presenting PowerShell examples before CLI examples, or alternate the order to avoid implicit prioritization of Windows tools.
GitHub Create Pull Request
Storage Discovery https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-discovery/deployment-planning.md ...main/articles/storage-discovery/deployment-planning.md
High Priority View Details →
Scanned: 2026-01-09 00:34
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation page demonstrates mild Windows bias by listing Azure PowerShell as a primary method for resource provider registration, mentioning it before Azure CLI, and providing no explicit Linux-specific guidance or examples. The instructions and tips reference Azure PowerShell and the Azure portal, both of which are more commonly used on Windows. There are no direct Linux shell (bash) or cross-platform CLI examples, and the documentation does not address platform-specific nuances or parity.
Recommendations
  • Provide explicit bash/Linux shell examples for Azure CLI commands, showing how to register resource providers and deploy workspaces from Linux environments.
  • When listing management options, alternate the order or explicitly state parity between Azure PowerShell and Azure CLI, clarifying that both are cross-platform.
  • Include a note or section on cross-platform usage, highlighting any differences or considerations for Linux/macOS users.
  • Reference Linux tools and patterns (e.g., scripting with bash, using environment variables) where appropriate.
  • Ensure that all instructions and examples are tested and validated on both Windows and Linux platforms.
GitHub Create Pull Request
Storage Discovery https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-discovery/create-workspace.md ...ob/main/articles/storage-discovery/create-workspace.md
High Priority View Details →
Scanned: 2026-01-09 00:34
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example
Summary
The documentation provides detailed instructions and a full example for Azure PowerShell, which is primarily used on Windows, before presenting an Azure CLI example. There is no mention of Bash or Linux-specific usage, and no Linux shell script examples are provided. The PowerShell example is more verbose and explanatory than the CLI example, indicating a bias toward Windows tooling and user patterns.
Recommendations
  • Add explicit Bash/Linux shell script examples for creating a workspace using Azure CLI.
  • Clarify that Azure CLI is cross-platform and can be used on Linux, macOS, and Windows.
  • Provide parity in example detail: ensure CLI examples are as comprehensive as PowerShell ones, including variable usage and object construction.
  • Mention installation and usage steps for Azure CLI on Linux.
  • Consider adding a section on automating workspace creation with Bash scripts for Linux users.
GitHub Create Pull Request
Storage Discovery https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-discovery/create-workspace.md ...ob/main/articles/storage-discovery/create-workspace.md
High Priority View Details →
Scanned: 2026-01-08 00:53
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example
Summary
The documentation page demonstrates Windows bias by providing a detailed Azure PowerShell example before the Azure CLI example, with no mention or examples of Linux-specific workflows or shell scripting. The PowerShell example is more verbose and instructive, while the CLI example is brief and lacks context. There are no references to Linux tools, shell environments, or guidance for non-Windows users.
Recommendations
  • Add explicit Bash or shell script examples for Linux/macOS users, including variable setting and command usage.
  • Provide parity in example depth and explanation between PowerShell and CLI sections.
  • Mention that Azure CLI is cross-platform and can be used on Linux, macOS, and Windows.
  • Include guidance for installing and using Azure CLI on Linux systems.
  • Consider reordering examples to present CLI first or side-by-side with PowerShell to avoid Windows-first bias.
GitHub Create Pull Request
Storage Discovery Create and manage an Azure Storage Discovery Workspace ...ob/main/articles/storage-discovery/create-workspace.md
Medium Priority View Details →
Scanned: 2026-01-13 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Powershell Heavy Windows First Missing Linux Example
Summary
The documentation provides detailed PowerShell instructions and examples for creating an Azure Storage Discovery workspace, which are specific to Windows environments. The PowerShell tab appears before the Azure CLI tab, and the CLI example is less detailed. There are no explicit Linux/macOS shell examples or notes about platform compatibility for the CLI, and no mention of Bash or other Linux-native tools.
Recommendations
  • Add explicit Bash examples for Linux/macOS users, showing equivalent commands and usage.
  • Clarify that Azure CLI works cross-platform and provide platform-specific notes where relevant.
  • Present CLI examples before PowerShell, or side-by-side, to avoid Windows-first ordering.
  • Include troubleshooting notes for Linux/macOS users if any steps differ from Windows.
GitHub Create Pull Request
Storage Discovery https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/storage-discovery/deployment-planning.md ...main/articles/storage-discovery/deployment-planning.md
Medium Priority View Details →
Scanned: 2026-01-08 00:53
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Powershell Heavy
Summary
The documentation page demonstrates a subtle Windows bias by listing Azure PowerShell as a primary method for registering resource provider namespaces, and by mentioning Azure portal (typically accessed from Windows environments) before Azure CLI. The tip specifically calls out manual registration when using PowerShell or CLI, but does not provide explicit Linux-oriented guidance or examples. There are no Linux-specific tools or shell examples, and the ordering of instructions favors Windows-centric tools.
Recommendations
  • Provide explicit Bash/Linux shell examples for Azure CLI commands, including copy-pasteable snippets.
  • List Azure CLI before Azure PowerShell when presenting cross-platform options, as CLI is natively supported on Linux and macOS.
  • Clarify that Azure portal and Azure CLI are fully supported on Linux and macOS, and provide links or notes for Linux users.
  • Add a section or callout for Linux deployment considerations, if any exist.
  • Avoid assuming PowerShell is the default automation tool; mention alternatives like Bash or zsh where appropriate.
GitHub Create Pull Request
Storage Discovery Create and manage an Azure Storage Discovery Workspace ...ob/main/articles/storage-discovery/create-workspace.md
Low Priority View Details →
Scanned: 2026-01-14 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Powershell Heavy Windows First
Summary
The documentation provides example scripts for both Azure PowerShell and Azure CLI, but the PowerShell example is given before the CLI example and is more detailed. PowerShell is a Windows-centric tool, and its prominence may create friction for Linux/macOS users. However, the CLI example is present and sufficient for Linux/macOS users to complete the task.
Recommendations
  • Present Azure CLI examples before PowerShell, or give both equal prominence.
  • Expand the Azure CLI example to match the detail and explanation provided in the PowerShell section.
  • Explicitly mention that Azure CLI works cross-platform and is recommended for Linux/macOS users.
  • Add a note clarifying that PowerShell Core is available cross-platform, but Azure CLI is typically preferred on Linux/macOS.
GitHub Create Pull Request
Storage Discovery Bicep template for creating an Azure Storage Discovery workspace ...n/articles/storage-discovery/create-workspace-bicep.md
Low Priority View Details →
Scanned: 2026-01-13 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation presents both Azure PowerShell and Azure CLI examples for deploying and reviewing resources. However, Azure PowerShell (a Windows-centric tool) is consistently listed first in all example tabs, and there are no explicit Linux/macOS shell examples (e.g., Bash, zsh). There is no mention of platform-specific considerations, nor are there instructions for installing or running Azure CLI/PowerShell on Linux/macOS. The documentation assumes parity but subtly prioritizes Windows tools and workflows.
Recommendations
  • Alternate the order of example tabs so Azure CLI (cross-platform) appears first, or explicitly note that CLI is recommended for Linux/macOS users.
  • Add a brief section on installing Azure CLI and Azure PowerShell on Linux/macOS, including links to official guides.
  • Include explicit Bash/zsh shell examples for Linux/macOS users, especially for file operations (e.g., saving the Bicep file).
  • Clarify that both Azure CLI and PowerShell are cross-platform, but CLI is natively available on Linux/macOS.
  • Add troubleshooting notes for common Linux/macOS issues (e.g., file permissions, path separators).
GitHub Create Pull Request
Storage Discovery Planning for an Azure Storage Discovery deployment ...main/articles/storage-discovery/deployment-planning.md
Low Priority View Details →
Scanned: 2026-01-13 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation page demonstrates mild Windows bias by listing Azure PowerShell as a primary method for resource provider registration, mentioning it before Azure CLI, and not providing explicit Linux/macOS-specific instructions or examples. The registration steps reference Azure portal and Azure PowerShell first, with Azure CLI mentioned last, and there are no explicit Bash or Linux/macOS command examples. However, Azure CLI is cross-platform and included, so Linux users can still follow the instructions.
Recommendations
  • Present Azure CLI examples before or alongside Azure PowerShell, as CLI is cross-platform and preferred by many Linux/macOS users.
  • Explicitly state that Azure CLI commands work on Linux/macOS and provide sample commands for both PowerShell and Bash shells.
  • Add a note clarifying that Azure PowerShell is primarily for Windows, while Azure CLI is available on all platforms.
  • Where possible, provide screenshots or terminal snippets from Linux/macOS environments to improve parity.
GitHub Create Pull Request