About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation exhibits a subtle Windows bias by using Windows-style file paths (e.g., 'C:/path/to/directory') in all code examples and never showing Linux/macOS equivalents. There are no explicit Linux or cross-platform file path examples, and no mention of platform-specific considerations for file paths or shell commands. While the Data Movement library itself is cross-platform, the documentation implicitly prioritizes Windows conventions, which may confuse or alienate Linux/macOS users.
Recommendations:
- Provide file path examples using both Windows (e.g., 'C:/path/to/directory') and Linux/macOS (e.g., '/home/user/path/to/directory') formats in code samples.
- Explicitly state that the Data Movement library and its CLI commands are cross-platform, and clarify any platform-specific behaviors or requirements.
- Where shell commands are shown (e.g., 'dotnet add package'), mention that these work on all supported platforms, and note any differences if they exist.
- Add a section or note about handling file paths in a cross-platform way in .NET (e.g., using Path.Combine or Path.DirectorySeparatorChar).
- Review all examples and documentation text to ensure that Linux/macOS users are equally represented and that no assumptions are made about the user's operating system.
Create pull request