add trouble shooting doc

Author: yejiyang

README.md

@@ -90,6 +90,7 @@ For comprehensive documentation, see the [`./doc/`](./doc/) directory:
 
 - **[Authentication Guide](./doc/AUTHENTICATION_GUIDE.md)**: Complete guide to all authentication methods
 - **[Advanced User Guide](./doc/ADVANCED_USER_GUIDE.md)**: In-depth coverage of sync/async operations and customizations
+- **[Troubleshooting Guide](./doc/TROUBLESHOOTING.md)**: Solutions for common issues, including Windows long path support
 - **[Examples Overview](./examples/EXAMPLES_OVERVIEW.md)**: Detailed overview of all available examples
 
 ## 🏗️ For Developers

doc/README.md

@@ -32,6 +32,12 @@ Information for project contributors and maintainers:
 - Release process
 - Maintenance procedures
 
+### 🔧 [Troubleshooting Guide](./TROUBLESHOOTING.md)
+
+Solutions for common installation and usage issues:
+
+- Windows long path support (required for some Windows users)
+
 ## Quick Start
 
 For most users, start with the main [README](../README.md) which covers basic usage.
@@ -42,6 +48,7 @@ For advanced usage patterns, see the [Advanced User Guide](./ADVANCED_USER_GUIDE
 
 ## Getting Help
 
+- **Troubleshooting**: Check the [Troubleshooting Guide](./TROUBLESHOOTING.md) for common issues and solutions
 - **Examples**: See [examples directory](../examples/examples/) for working code samples
 - **Issues**: Report bugs or request features on [GitHub](https://github.com/norwegian-geotechnical-institute/field-manager-python-client/issues)
 - **Support**: Contact the development team for assistance

doc/TROUBLESHOOTING.md

@@ -0,0 +1,42 @@
+# Troubleshooting Guide
+
+This guide helps resolve common issues encountered when installing the Field Manager Python Client.
+
+## Windows Long Path Support
+
+**Problem**: Windows users may encounter installation errors due to the 260-character path length limitation:
+
+```
+OSError: [Errno 22] Invalid argument: '...'
+FileNotFoundError: [Errno 2] No such file or directory
+ERROR: Could not install packages due to an EnvironmentError
+```
+
+This is particularly common with the field-manager-python-client library due to its nested directory structure.
+
+**Solution**: Enable Windows long path support using PowerShell (requires administrator privileges):
+
+1. **Open PowerShell as Administrator**:
+   - Right-click Start button → "Windows PowerShell (Admin)"
+   - Or search for PowerShell, right-click, "Run as administrator"
+
+2. **Run the command**:
+   ```powershell
+   New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
+   ```
+
+3. **Restart your computer** for changes to take effect
+
+## Getting Help
+
+If you're still experiencing issues:
+
+1. **Check GitHub Issues**: [field-manager-python-client issues](https://github.com/norwegian-geotechnical-institute/field-manager-python-client/issues)
+
+2. **Create a detailed issue** including:
+   - Operating system and version
+   - Python version (`python --version`)
+   - Complete error message
+   - Steps to reproduce the problem
+
+## Frequently Asked Questions