Bias Analysis
Detected 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