Detected Bias Types
🔧
Windows Tools
Windows First
Missing Linux Example
Powershell Heavy
Summary
The documentation page demonstrates a notable Windows bias. Many features, examples, and references are Windows-centric, such as repeated mentions of Windows tools (FSCTLs, VSS, Hyper-V, NTFS semantics, LMHOSTS, Windows quota semantics), links to Windows documentation, and explanations that assume Windows client behaviors. Linux/macOS equivalents are rarely mentioned, and when they are (e.g., UNIX extensions, dual protocol), they're described as disabled or unsupported. There are no Linux/macOS-specific configuration examples or troubleshooting notes, and Windows features are discussed first and in detail.
Recommendations
- Add explicit examples and guidance for Linux and macOS SMB clients, including mounting instructions, expected behaviors, and troubleshooting tips.
- Include references to Linux tools (e.g., smbclient, mount.cifs) and how they interact with Azure NetApp Files.
- Document differences in file semantics (e.g., delete behavior, symlinks, permissions) between Windows and UNIX clients, and provide best practices for mixed environments.
- Clarify which features are relevant or irrelevant for non-Windows clients, and provide parity tables or notes.
- Link to Linux/macOS SMB documentation where appropriate, not only Windows docs.
- Highlight any limitations or workarounds for Linux/macOS users up front.