From 25b338582fe8d81d8e8381641f0e0684521bba1d Mon Sep 17 00:00:00 2001
From: zocomputer <help@zocomputer.com>
Date: Mon, 20 Apr 2026 15:24:36 +0000
Subject: [PATCH] docs: add troubleshooting section to CONTRIBUTING

- Added FAQ for common issues: large files, format detection, gzip support
---
 CONTRIBUTING.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index e9deea0..28a38bb 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -150,3 +150,16 @@ By contributing to Log Analyzer CLI, you agree that your contributions will be l
 - **Discussions**: For questions and general discussion
 
 We appreciate all contributions, from bug reports to new features!
+
+## Troubleshooting
+
+### Common Issues
+
+**Q: Large files cause memory issues?**
+A: Use streaming mode with `--stream` flag for files over 100MB.
+
+**Q: Log format not detected?**
+A: Manually specify format with `--format json|syslog|apache|generic`.
+
+**Q: Gzip compressed files not reading?**
+A: Ensure `.gz` extension is present; auto-detection handles gzip.