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
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation page demonstrates a Windows bias by presenting Windows tools (robocopy) and detailed usage instructions first, with extensive examples and option explanations. In contrast, Linux instructions are minimal, lacking detailed examples for copying metadata (ACLs, attributes, timestamps) and omitting step-by-step guidance for Linux-specific tools (e.g., smbcacls, cifsacl). The Linux section does not provide equivalent depth or clarity, making it harder for Linux users to achieve parity in functionality.
Recommendations:
- Provide Linux examples with the same level of detail as the Windows section, including step-by-step commands for copying both data and metadata (ACLs, attributes, timestamps).
- Include explanations of relevant Linux tools (e.g., smbcacls, cifsacl, getfacl/setfacl) and their options, similar to the robocopy option table.
- Present Linux and Windows instructions in parallel sections or side-by-side, rather than Windows-first, to avoid the perception of prioritizing one platform.
- Clarify any limitations or differences in metadata preservation between Windows and Linux up front, and offer workarounds or best practices for Linux users.
- Add links to Linux-specific documentation or tutorials for copying ACLs and metadata to Azure Files.
Create pull request