Data Share
37
Total Pages
34
Linux-Friendly Pages
3
Pages with Bias
8.1%
Bias Rate
Bias Trend Over Time
Pages with Bias Issues
24 issues found
Showing 1-24 of 24 flagged pages
Data Share
Tutorial: Share outside your org - Azure Data Share
...-docs/blob/main/articles/data-share/share-your-data.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell, with PowerShell being highlighted as a primary automation method. PowerShell examples include references to Windows file paths (e.g., D:\testFiles\textfile.csv) and local file upload patterns typical for Windows environments. There is no mention of Linux-specific shell commands (e.g., Bash), Linux file paths, or cross-platform scripting alternatives. The PowerShell section suggests running commands locally or in Azure Cloud Shell, but does not offer Bash equivalents or guidance for Linux users. The documentation implicitly assumes familiarity with Windows tools and patterns, and presents PowerShell before any Linux-specific alternatives.
Recommendations
- Add Bash shell examples alongside PowerShell, especially for resource creation and file uploads.
- Include Linux file path examples (e.g., /home/user/testFiles/textfile.csv) in upload scenarios.
- Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and provide guidance for Linux users.
- Provide links to Linux-specific quickstarts or guides for Azure Data Share.
- Balance the prominence of PowerShell and Bash in tabbed code samples, or offer a 'Linux' tab where appropriate.
- Avoid using Windows-specific file paths in generic examples, or provide both Windows and Linux variants.
Create Pull Request
Data Share
Tutorial: Accept & receive data - Azure Data Share
...ob/main/articles/data-share/subscribe-to-data-share.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Summary
The documentation provides step-by-step instructions for Azure Data Share using the Azure Portal, Azure CLI, and PowerShell. While Azure CLI is cross-platform, the PowerShell examples and instructions are prominent and detailed, including references to Windows file paths (e.g., D:\testFiles) and PowerShell-specific commands. There are no explicit Linux shell (bash) or scripting examples, and the PowerShell section assumes familiarity with Windows conventions. Additionally, PowerShell is mentioned as usable in the Azure Cloud Shell Bash environment, but no native bash or Linux shell alternatives are provided. This results in a Windows-centric bias, especially for users who prefer or require Linux-native workflows.
Recommendations
- Add explicit bash (Linux shell) examples alongside PowerShell, especially for file upload/download and storage operations.
- Replace or supplement Windows file path examples (e.g., D:\testFiles) with Linux-style paths (e.g., /home/user/testFiles) where relevant.
- Clarify that Azure CLI commands work natively on Linux/macOS and provide any necessary bash scripting context (e.g., variable assignment, JSON parsing).
- Where PowerShell is referenced, note that cross-platform PowerShell Core is available, but also provide equivalent bash commands for parity.
- Ensure that instructions for preparing the environment and managing files are not solely focused on Windows tools or conventions.
Data Share
Tutorial: Share outside your org - Azure Data Share
...-docs/blob/main/articles/data-share/share-your-data.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell, with PowerShell being featured as a primary scripting option alongside Azure CLI. PowerShell is a Windows-centric tool, and its usage is emphasized, including references to local PowerShell environments and Windows file paths (e.g., D:\testFiles\textfile.csv). There are no examples using Bash, Linux shell scripting, or cross-platform alternatives for file upload and management. The PowerShell examples assume a Windows environment, and the documentation does not provide parity for Linux users in terms of command-line examples or tooling.
Recommendations
- Add Bash/Linux shell examples for all CLI operations, especially for file uploads and resource management.
- Replace or supplement Windows file path examples (e.g., D:\testFiles\textfile.csv) with Linux equivalents (e.g., /home/user/testFiles/textfile.csv).
- Clarify that Azure CLI commands work cross-platform and provide explicit instructions for Linux/macOS users where relevant.
- Include guidance for using Azure Cloud Shell (Bash) and note its cross-platform nature.
- Avoid assuming PowerShell is the default scripting environment; mention alternatives and provide links to Linux/macOS setup guides.
Data Share
Tutorial: Accept & receive data - Azure Data Share
...ob/main/articles/data-share/subscribe-to-data-share.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Missing Linux Example
Summary
The documentation provides detailed instructions and code samples for Azure Portal, Azure CLI, and PowerShell. However, the PowerShell examples are prominent and include Windows-specific paths (e.g., D:\testFiles), and there is no mention of Linux shell scripting or cross-platform alternatives for tasks like file uploads. The PowerShell section assumes a Windows environment, and there are no explicit Bash or Linux-native examples for common operations (such as uploading files to Azure Storage). Additionally, PowerShell is referenced as being usable in the Azure Cloud Shell (which is cross-platform), but the examples and file paths are still Windows-centric. There is also no mention of Linux tools or patterns, and the documentation does not provide parity for Linux users in several steps.
Recommendations
- Add explicit Bash/Linux shell examples for all tasks, especially for file operations (e.g., uploading files to Azure Storage using az storage blob upload or azcopy).
- Replace or supplement Windows file paths (e.g., D:\testFiles) with Linux equivalents (e.g., /home/user/testFiles) in code samples.
- Clarify that Azure CLI and PowerShell can be used on both Windows and Linux, and provide guidance for setting up environments on both platforms.
- Where PowerShell is referenced, include Bash alternatives or note that the same can be accomplished with Azure CLI commands.
- Ensure that all instructions and screenshots are not Windows-specific, or provide Linux equivalents where applicable.
- Explicitly mention cross-platform tools (e.g., azcopy, Azure CLI) and provide links to their installation and usage guides for Linux.
Data Share
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/data-share/subscribe-to-data-share.md
...ob/main/articles/data-share/subscribe-to-data-share.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Missing Linux Example
Summary
The documentation page demonstrates a Windows bias in several ways. PowerShell is featured prominently as a first-class automation option, with detailed step-by-step instructions and examples. Many commands reference Windows-specific paths (e.g., D:\testFiles) and tools (PowerShell, Azure PowerShell modules), and there are no examples for Linux-native shells or scripting (such as Bash or shell scripts). The PowerShell tab is presented alongside Azure CLI and Portal, but Linux-specific nuances (such as using Bash, zsh, or Linux file paths) are absent. Additionally, references to local file operations use Windows conventions, and there is no mention of Linux equivalents or cross-platform considerations.
Recommendations
- Add explicit Bash/shell examples for all CLI steps, including variable assignment and file operations, using Linux file paths (e.g., /home/user/testFiles/textfile.csv).
- Clarify that Azure CLI commands work cross-platform, and provide Linux-specific setup instructions (e.g., installing Azure CLI on Ubuntu, using Bash variables).
- For PowerShell examples, note that PowerShell Core is available on Linux and macOS, and provide guidance for running these commands in non-Windows environments.
- Replace or supplement Windows file path examples (e.g., D:\testFiles) with Linux/macOS equivalents (/home/user/testFiles).
- Add a section or note on cross-platform compatibility, including any differences in authentication, file system access, or environment setup between Windows and Linux.
- Where local file operations are described, provide both Windows and Linux command examples (e.g., using cp, mv, or uploading files from Linux directories).
Data Share
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/data-share/share-your-data.md
...-docs/blob/main/articles/data-share/share-your-data.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell, with PowerShell being highlighted as a primary automation option. Several examples and instructions reference Windows-centric tools and patterns, such as using PowerShell and referencing local Windows file paths (e.g., D:\testFiles). There is no mention of Linux shell equivalents (e.g., Bash scripts for uploading files), and PowerShell is presented as the main scripting option, which is most familiar to Windows users. Additionally, the PowerShell tab is included before any mention of Linux/Bash alternatives, and there are no explicit Linux-specific instructions or examples.
Recommendations
- Add Bash shell examples alongside PowerShell for all CLI operations, especially for file uploads and resource management.
- Include Linux-specific instructions for preparing the environment, such as installing Azure CLI on Ubuntu or other distributions.
- Replace or supplement Windows file path examples (e.g., D:\testFiles) with Linux-style paths (e.g., /home/user/testFiles).
- Clarify that Azure CLI commands work cross-platform and provide explicit examples for Linux/macOS users.
- Mention and link to documentation for using Azure Cloud Shell in Bash mode, not just PowerShell.
- Ensure parity in troubleshooting and environment setup guidance for Linux users.
Data Share
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/data-share/share-your-data.md
...-docs/blob/main/articles/data-share/share-your-data.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell, but the PowerShell examples are prominent and include Windows-specific file paths (e.g., D:\testFiles\textfile.csv) and usage patterns. There is no mention of Linux-specific shell commands (e.g., Bash), nor are there examples using Linux-native tools or file paths. PowerShell is presented as a primary automation method alongside Azure CLI, but Linux/Bash alternatives are missing. The documentation also references launching Cloud Shell, which supports Bash, but does not provide Bash examples. This creates a subtle bias toward Windows and PowerShell environments.
Recommendations
- Add Bash shell examples for all CLI procedures, especially for resource creation and file uploads.
- Replace or supplement Windows file paths (e.g., D:\testFiles\textfile.csv) with Linux-style paths (e.g., /home/user/testFiles/textfile.csv) in examples.
- Explicitly mention that Azure CLI commands can be run in Bash on Linux/macOS, and provide guidance for Linux users where relevant.
- Where PowerShell is referenced, provide equivalent Bash or shell script alternatives for Linux users.
- Clarify that Cloud Shell supports both Bash and PowerShell, and offer examples for both environments.
Data Share
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/data-share/subscribe-to-data-share.md
...ob/main/articles/data-share/subscribe-to-data-share.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Missing Linux Example
Summary
The documentation page demonstrates a Windows bias in several ways: PowerShell is featured as a primary automation method alongside Azure CLI and Portal, with extensive PowerShell examples and references to Windows file paths (e.g., D:\testFiles). There is no mention of Linux-specific shell commands (such as Bash scripts), nor are Linux file system conventions used in examples. The use of PowerShell and Windows-centric patterns (like local file uploads from D:\) may disadvantage Linux users, and there are no explicit Linux or Bash alternatives provided.
Recommendations
- Add Bash shell examples alongside PowerShell, especially for steps involving local file operations and Azure CLI usage.
- Replace or supplement Windows file path examples (e.g., D:\testFiles) with Linux equivalents (e.g., /home/user/testFiles).
- Explicitly mention that Azure CLI commands can be run in Bash on Linux/macOS, and provide any necessary environment setup instructions for those platforms.
- Include notes or sections on how to perform equivalent tasks on Linux, such as uploading files from a Linux file system or using Bash scripting.
- Review and update references to Windows-specific tools or conventions to ensure parity with Linux workflows.
Data Share
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/data-share/share-your-data.md
...-docs/blob/main/articles/data-share/share-your-data.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell. The PowerShell examples are prominent and include references to Windows file paths (e.g., D:\testFiles\textfile.csv) and Windows-centric tooling. There is no mention of Linux-specific tools, shell environments, or file path conventions. PowerShell is presented as a primary automation method, and the PowerShell tab includes instructions for running commands locally or in Azure Cloud Shell, but does not address Bash or Linux-native scripting. The CLI examples are cross-platform, but the PowerShell content and file path examples show a Windows bias.
Recommendations
- Add explicit Bash examples alongside PowerShell, especially for automation and scripting tasks.
- When referencing file paths, use cross-platform examples or provide both Windows (e.g., D:\testFiles\textfile.csv) and Linux (e.g., /home/user/testFiles/textfile.csv) path formats.
- Mention that Azure CLI commands can be run in Bash on Linux/macOS, and provide guidance for those environments.
- Clarify that PowerShell Core is cross-platform, but provide Bash alternatives for users who prefer native Linux tools.
- Avoid referring to Windows-specific folders or drive letters without Linux equivalents.
- Include links to Linux-specific quickstarts or guides where available.
Data Share
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/data-share/share-your-data-arm.md
...s/blob/main/articles/data-share/share-your-data-arm.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Missing Linux Example
Windows Tools
Summary
The documentation provides only Azure PowerShell examples for resource cleanup, with no mention of equivalent commands for Linux users (such as Azure CLI or Bash). The use of PowerShell-specific syntax and the lack of cross-platform command options indicate a Windows bias. There is also no reference to Linux or macOS tooling or workflows.
Recommendations
- Include Azure CLI (az) command examples for all resource management steps, especially for cleanup, alongside PowerShell.
- Explicitly mention that the steps can be performed on any OS, and provide Bash or shell script equivalents where relevant.
- Add a note or section for Linux/macOS users, highlighting any differences or confirming parity.
- Where PowerShell is used, clarify that Azure CLI is also supported and link to relevant CLI documentation.
Data Share
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/data-share/share-your-data.md
...-docs/blob/main/articles/data-share/share-your-data.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell, with significant emphasis on PowerShell and Windows-centric tooling. PowerShell examples are detailed and include references to Windows file paths (e.g., D:\testFiles), and the PowerShell section suggests running commands locally or in Azure Cloud Shell. There is no mention of Linux-specific shell usage, nor are there any Bash or Linux-native command examples. The documentation assumes familiarity with Windows conventions and tools, and does not provide parity for Linux users.
Recommendations
- Add explicit Bash examples alongside PowerShell, especially for common tasks like uploading files to Azure Storage.
- Avoid using Windows-specific file paths (e.g., D:\testFiles) in examples; provide cross-platform alternatives or note Linux equivalents (e.g., /home/user/testFiles).
- Clarify that Azure CLI commands work on Linux, macOS, and Windows, and provide sample commands in Bash syntax where appropriate.
- Mention that Azure Cloud Shell supports both Bash and PowerShell, and provide guidance for both environments.
- Where PowerShell is referenced, include a note or section for Linux users on how to install and use PowerShell Core if needed, or suggest equivalent Bash commands.
- Ensure that documentation does not assume a Windows environment by default, and structure examples so that Linux and Windows users are equally supported.
Data Share
https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/data-share/subscribe-to-data-share.md
...ob/main/articles/data-share/subscribe-to-data-share.md
High Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Missing Linux Example
Summary
The documentation provides extensive PowerShell examples, including file paths and commands that are specific to Windows environments (e.g., D:\testFiles), and references to PowerShell as a primary automation tool. While Azure CLI examples are present (which are cross-platform), the PowerShell sections are more detailed, and there are no explicit Linux shell (bash) or native Linux file system examples. The documentation also references Windows-style file paths and omits Linux-specific guidance for file uploads or scripting, potentially making it less approachable for Linux users.
Recommendations
- Add explicit bash/Linux shell examples alongside PowerShell, especially for file operations (e.g., uploading files to Azure Storage using az CLI and Linux file paths like /home/user/testFiles/textfile.csv).
- Avoid using Windows-specific file paths (e.g., D:\testFiles) in generic examples; provide both Windows and Linux path variants.
- Clarify that PowerShell commands can be run cross-platform (e.g., in Azure Cloud Shell), but also provide equivalent bash/CLI workflows for Linux users.
- Ensure that all automation and scripting examples are available in both PowerShell and bash/CLI formats, with equal detail and explanation.
- Mention Linux tools (e.g., azcopy, curl, or bash scripting) where appropriate, not just Windows-centric tools.
Data Share
Tutorial: Accept & receive data - Azure Data Share
...ob/main/articles/data-share/subscribe-to-data-share.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation provides step-by-step instructions for accepting and receiving data via Azure Data Share, with examples for Azure Portal, Azure CLI, and PowerShell. While Azure CLI is cross-platform, PowerShell examples and references are prominent and sometimes include Windows-centric paths (e.g., D:\testFiles). PowerShell is presented as a first-class option alongside CLI, but there are no explicit Linux/macOS shell (bash) examples for tasks like file uploads or storage management. The PowerShell examples assume familiarity with Windows file system conventions and do not mention Linux/macOS equivalents, which may cause friction for non-Windows users.
Recommendations
- Add explicit bash (Linux/macOS) examples for file operations, such as uploading files to Azure Storage using az CLI or Azure Storage SDKs.
- Replace or supplement Windows-style file paths (e.g., D:\testFiles) with Linux/macOS equivalents (e.g., /home/user/testFiles) in examples.
- Clarify that Azure CLI commands work on Linux/macOS and Windows, and provide sample shell commands for common tasks (e.g., creating containers, uploading files) using az CLI.
- Where PowerShell is referenced, note that Azure PowerShell is available cross-platform, but provide guidance or links for Linux/macOS installation and usage.
- Consider reordering examples so that cross-platform CLI instructions appear before PowerShell, or present both equally.
Data Share
Tutorial: Share outside your org - Azure Data Share
...-docs/blob/main/articles/data-share/share-your-data.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Windows Tools
Summary
The documentation provides equivalent instructions for Azure Portal, Azure CLI, and PowerShell. However, the PowerShell examples and guidance are prominent and include Windows-centric paths (e.g., D:\testFiles), and PowerShell is traditionally a Windows-first tool. The PowerShell tab is present alongside CLI, but examples such as file upload use Windows-style paths and do not mention Linux/macOS alternatives. There is no explicit Linux/macOS example for uploading files, and PowerShell requirements are referenced without clarifying cross-platform usage.
Recommendations
- Add explicit notes that Azure PowerShell is cross-platform and can be used on Linux/macOS, or clarify when examples are Windows-specific.
- For file upload examples, include both Windows and Linux/macOS path formats (e.g., D:\testFiles\textfile.csv and /home/user/testFiles/textfile.csv).
- Where PowerShell is referenced, mention that Azure CLI is fully supported on Linux/macOS and provide parity in examples.
- Consider reordering tabs so that Azure CLI (which is natively cross-platform) appears before PowerShell.
- Add a brief section or callout confirming that all steps can be completed on Linux/macOS using Azure CLI or PowerShell Core.
Data Share
Tutorial: Share outside your org - Azure Data Share
...-docs/blob/main/articles/data-share/share-your-data.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Windows Tools
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell. PowerShell is given equal prominence to Azure CLI, but its usage and examples (such as file upload from D:\testFiles) are Windows-centric. The PowerShell examples reference Windows file paths and tools, and the PowerShell section is included as a primary method, which may create friction for Linux/macOS users. There are no explicit Linux/macOS shell examples (e.g., Bash), and PowerShell is presented as a default automation option alongside CLI, despite its historical Windows bias.
Recommendations
- Add explicit Bash examples for key steps, especially for file upload and resource management, to ensure Linux/macOS users have parity.
- Clarify that PowerShell commands can be run cross-platform (e.g., in Azure Cloud Shell) and provide Linux/macOS path examples where relevant.
- Avoid using Windows-specific file paths (e.g., D:\testFiles) in PowerShell examples; use generic or platform-neutral paths.
- Consider listing Azure CLI (which is cross-platform) before PowerShell in example tabs to reduce perceived Windows-first bias.
Data Share
Tutorial: Accept & receive data - Azure Data Share
...ob/main/articles/data-share/subscribe-to-data-share.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation provides step-by-step instructions for accepting and receiving data via Azure Data Share using three interfaces: Azure Portal, Azure CLI, and PowerShell. While Azure CLI is cross-platform, PowerShell examples are given equal prominence and detail, and in some cases, Windows-centric file paths (e.g., D:\testFiles) are used in examples. There is no mention of Linux/macOS-specific considerations, nor are Bash or shell script examples provided for tasks like file uploads. PowerShell is presented as a first-class option alongside CLI, but with Windows-centric patterns, which may create friction for Linux/macOS users.
Recommendations
- Add explicit Bash/shell script examples for file uploads and other operations, especially where PowerShell uses Windows paths.
- Clarify that Azure CLI is fully cross-platform and can be used on Linux/macOS, and provide links to CLI installation for those platforms.
- Where PowerShell is used for local operations, provide equivalent Bash commands for Linux/macOS users (e.g., using azcopy, Azure CLI, or REST API for file uploads).
- Avoid using Windows-specific file paths in examples; use generic or platform-neutral paths, or provide alternatives.
- Add a note or section for Linux/macOS users highlighting any differences or additional steps required.
Data Share
Tutorial: Share outside your org - Azure Data Share
...-docs/blob/main/articles/data-share/share-your-data.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell. While Azure CLI is cross-platform, the PowerShell examples and instructions are Windows-centric, including references to local file paths (e.g., 'D:\testFiles') and PowerShell-specific guides. There is no mention of Linux/macOS equivalents for file upload or shell usage, and PowerShell is presented as a primary automation option alongside CLI, which may create friction for Linux/macOS users unfamiliar with PowerShell.
Recommendations
- Add explicit Bash shell examples for common tasks such as uploading files to Azure Storage, using azcopy or Azure CLI from Bash.
- Clarify that Azure CLI commands work on Linux/macOS and provide sample commands using Unix-style file paths (e.g., '/home/user/testFiles/textfile.csv').
- Where PowerShell is referenced, note that PowerShell Core is available cross-platform, and provide instructions or examples for installing and using it on Linux/macOS.
- Avoid using Windows-style file paths in generic examples, or provide both Windows and Unix-style path examples.
- Link to cross-platform guides for Azure Cloud Shell, emphasizing its availability from any OS.
Data Share
Tutorial: Accept & receive data - Azure Data Share
...ob/main/articles/data-share/subscribe-to-data-share.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation provides step-by-step instructions for using the Azure Portal, Azure CLI, and PowerShell to accept and receive data via Azure Data Share. While Azure CLI is cross-platform and examples are provided, PowerShell examples are given equal prominence and detail, including local file paths and Windows-centric usage patterns (e.g., referencing 'D:\testFiles'). There are no explicit Linux/macOS shell examples (e.g., Bash scripts for file upload), and PowerShell-specific instructions (including local execution) may confuse Linux/macOS users. The ordering of examples sometimes places PowerShell before CLI, and file path examples are Windows-centric.
Recommendations
- Add explicit Bash/shell examples for file upload and storage operations, especially for steps currently showing only PowerShell with Windows file paths.
- Clarify that PowerShell commands can be run in Azure Cloud Shell (which is cross-platform), but provide alternative Bash/CLI instructions for local execution on Linux/macOS.
- Avoid using Windows-specific file paths (e.g., 'D:\testFiles') in generic examples; use platform-neutral or Azure Cloud Shell paths.
- Ensure CLI examples are shown first or equally, and highlight their cross-platform compatibility.
- Add notes or links for Linux/macOS users on how to perform equivalent tasks (e.g., uploading files to Azure Storage using az CLI or azcopy).
Data Share
Tutorial: Share outside your org - Azure Data Share
...-docs/blob/main/articles/data-share/share-your-data.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation provides parallel examples for Azure Portal, Azure CLI, and PowerShell. However, the PowerShell examples and instructions are notably more detailed, and some file upload examples use Windows-style paths (e.g., D:\testFiles\textfile.csv) without Linux/macOS equivalents. There is no explicit mention of Linux/macOS-specific instructions or examples, especially for file uploads and local environment setup. The Azure CLI examples are cross-platform, but PowerShell is Windows-centric and presented with more context and detail.
Recommendations
- Add explicit Linux/macOS file path examples (e.g., /home/user/testFiles/textfile.csv) alongside Windows paths in PowerShell and CLI sections.
- Clarify that PowerShell Core is available on Linux/macOS, and provide instructions for installing and running PowerShell on those platforms.
- Include Bash examples for file uploads to Azure Storage using az CLI or other cross-platform tools.
- Balance the detail level between PowerShell and Azure CLI sections to ensure parity for non-Windows users.
- Note any platform-specific limitations or differences where relevant.
Data Share
Tutorial: Accept & receive data - Azure Data Share
...ob/main/articles/data-share/subscribe-to-data-share.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell. While Azure CLI is cross-platform, PowerShell examples are given equal prominence and detail, and some PowerShell commands reference Windows-specific file paths (e.g., D:\testFiles). There are no explicit Linux/macOS shell examples (e.g., Bash scripts for file upload), and PowerShell is presented as a primary automation option, which may create friction for Linux/macOS users. Additionally, in some sections, PowerShell instructions reference running commands locally or in Azure Cloud Shell, but do not clarify Linux usage or alternatives.
Recommendations
- Add explicit Bash or shell script examples for file operations, especially for uploading files to Azure Storage from Linux/macOS.
- Clarify that Azure CLI commands work equally on Windows, Linux, and macOS, and highlight any OS-specific considerations.
- Avoid Windows-specific file paths in examples (e.g., use generic paths or show both Windows and Linux/macOS variants).
- Where PowerShell is referenced, note that Azure Cloud Shell supports Bash and PowerShell, and provide Bash equivalents for common tasks.
- Consider reordering examples so that cross-platform options (Azure CLI, Bash) are presented before PowerShell.
Data Share
Tutorial: Accept & receive data - Azure Data Share
...ob/main/articles/data-share/subscribe-to-data-share.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Windows Tools
Summary
The documentation provides parallel examples for Azure Portal, Azure CLI, and PowerShell, but PowerShell is given significant prominence and detail, including explicit references to Windows file paths (e.g., D:\testFiles\textfile.csv) and storage operations that are Windows-centric. PowerShell is traditionally associated with Windows, and the examples assume a Windows environment for local file operations. There is no mention of Linux/macOS equivalents for file paths or shell usage, and PowerShell examples are detailed and sometimes referenced as usable in Bash only via Azure Cloud Shell, not locally on Linux/macOS. The CLI examples are cross-platform, but the documentation does not clarify or encourage Linux/macOS usage, nor does it provide guidance for non-Windows users in PowerShell sections.
Recommendations
- Add explicit Linux/macOS examples for file paths and local operations (e.g., use /home/user/testFiles/textfile.csv in CLI and PowerShell examples).
- Clarify that Azure CLI is fully cross-platform and recommend it for Linux/macOS users.
- In PowerShell sections, note that PowerShell Core is available on Linux/macOS and provide examples or notes for those platforms.
- Avoid using Windows-specific file paths in examples, or provide both Windows and Linux/macOS variants.
- Add a note in prerequisites or introduction about cross-platform support and best practices for non-Windows users.
Data Share
Tutorial: Share outside your org - Azure Data Share
...-docs/blob/main/articles/data-share/share-your-data.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows Tools
Windows First
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell, with PowerShell examples and references to Windows file paths (e.g., D:\testFiles) and tools. There is a notable emphasis on PowerShell, which is traditionally a Windows-centric tool, and examples use Windows-style paths. There are no explicit Linux/macOS shell examples (e.g., Bash), nor are Linux-specific instructions or parity considerations mentioned. PowerShell is presented as a primary automation method alongside Azure CLI, but Linux-native alternatives are not discussed.
Recommendations
- Add Bash shell examples for Linux/macOS users, especially for file upload and resource management tasks.
- Replace or supplement Windows-style file paths (e.g., D:\testFiles) with POSIX-style paths (e.g., /home/user/testFiles) in examples.
- Clarify that Azure CLI commands work cross-platform and provide explicit instructions for Linux/macOS environments where relevant.
- Mention that PowerShell Core is available on Linux/macOS, and provide guidance or links for installation and usage on those platforms.
- Ensure that screenshots and instructions do not assume a Windows environment unless necessary.
Data Share
Tutorial: Share outside your org - Azure Data Share
...-docs/blob/main/articles/data-share/share-your-data.md
Medium Priority
View Details →
Detected Bias Types
Powershell Heavy
Windows First
Windows Tools
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell. PowerShell is featured as a primary automation method, and several examples (e.g., uploading files) reference Windows-specific file paths (e.g., D:\testFiles\textfile.csv). PowerShell is traditionally associated with Windows, and its usage may imply a Windows-centric workflow. The CLI examples are cross-platform, but PowerShell is given equal prominence, and Windows file path conventions are used in examples before mentioning alternatives. There is no explicit mention of Linux/macOS-specific considerations, nor are Bash or shell script examples provided.
Recommendations
- Add Bash/shell script examples for key tasks alongside PowerShell, especially for file uploads and resource management.
- Use platform-neutral file paths in examples (e.g., /home/user/testFiles/textfile.csv) or provide both Windows and Linux/macOS variants.
- Explicitly state that Azure CLI works on Linux/macOS and provide guidance for Linux/macOS users where workflows may differ.
- Where PowerShell is referenced, clarify that PowerShell Core is available cross-platform, and provide installation instructions for Linux/macOS.
- Add troubleshooting notes for common Linux/macOS issues (e.g., file permissions, path separators) when working with Azure Data Share.
Data Share
Tutorial: Accept & receive data - Azure Data Share
...ob/main/articles/data-share/subscribe-to-data-share.md
Medium Priority
View Details →
Detected Bias Types
Windows First
Powershell Heavy
Windows Tools
Summary
The documentation provides examples for Azure Portal, Azure CLI, and PowerShell. PowerShell examples are given equal prominence to Azure CLI, but several PowerShell commands and patterns (e.g., file upload from D:\testFiles, use of Set-AzStorageBlobContent, and references to Windows file paths) are Windows-centric. There are no explicit Linux/macOS-specific instructions or examples, and PowerShell is traditionally a Windows-first tool, though it is now cross-platform. The CLI examples are platform-neutral, but the PowerShell examples assume Windows conventions and tools. Additionally, in some sections, PowerShell instructions are presented before or alongside CLI, but never with explicit Linux shell (bash) or macOS alternatives.
Recommendations
- Add explicit bash/Linux/macOS shell examples where file operations are involved, especially for uploading files to Azure Storage.
- Clarify that Azure CLI commands work on Linux/macOS and provide any necessary environment setup instructions for those platforms.
- Avoid using Windows-specific file paths (e.g., D:\testFiles) in PowerShell examples; use platform-neutral or cross-platform paths.
- Mention that PowerShell Core is available on Linux/macOS, and provide guidance for installing and running PowerShell on those platforms.
- Provide parity in troubleshooting and environment setup instructions for Linux/macOS users.