docs: Add quick start, contributing, and troubleshooting guides.

Author: southpawriter02

CONTRIBUTING.md

@@ -0,0 +1,46 @@
+# Contributing
+
+Thank you for your interest in contributing to git-chronoscope!
+
+## Development Setup
+
+```bash
+# Clone repository
+git clone https://github.com/user/git-chronoscope.git
+cd git-chronoscope
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install dependencies
+pip install -r requirements.txt
+pip install -r requirements-dev.txt  # For testing
+```
+
+## Running Tests
+
+```bash
+python -m unittest discover tests
+```
+
+## Pull Request Process
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make changes and add tests
+4. Run tests (`python -m unittest discover tests`)
+5. Commit (`git commit -m 'Add amazing feature'`)
+6. Push (`git push origin feature/amazing-feature`)
+7. Open a Pull Request
+
+## Code Style
+
+- Follow PEP 8
+- Use type hints where possible
+- Add docstrings to functions and classes
+- Keep functions focused and small
+
+## Questions?
+
+Open an issue for questions or discussions.

QUICKSTART.md

@@ -0,0 +1,48 @@
+# Quick Start
+
+Generate your first time-lapse in 5 minutes.
+
+## 1. Install
+
+```bash
+# Clone
+git clone https://github.com/user/git-chronoscope.git
+cd git-chronoscope
+
+# Install dependencies
+pip install -r requirements.txt
+```
+
+## 2. Prerequisites
+
+- Git installed
+- FFmpeg installed (for video output)
+
+## 3. Generate Time-Lapse
+
+```bash
+# Basic usage
+python -m src.main /path/to/your/repo output.mp4
+
+# With options
+python -m src.main /path/to/repo output.mp4 --fps 10 --resolution 1080p
+```
+
+## 4. View Result
+
+Open `output.mp4` to see your repository's evolution!
+
+## Common Options
+
+| Option | Description |
+|--------|-------------|
+| `--fps 10` | Frames per second |
+| `--resolution 1080p` | Video resolution |
+| `--format gif` | Output as GIF |
+| `--include "*.py"` | Filter files |
+| `--dry-run` | Preview without generating |
+
+## Next Steps
+
+- See `README.md` for full documentation
+- See `TROUBLESHOOTING.md` if you encounter issues

TROUBLESHOOTING.md

@@ -0,0 +1,60 @@
+# Troubleshooting
+
+Common problems and solutions.
+
+## FFmpeg Not Found
+
+**Error:** `FFmpeg not found in PATH`
+
+**Solution:**
+```bash
+# macOS
+brew install ffmpeg
+
+# Ubuntu/Debian
+sudo apt-get install ffmpeg
+
+# Windows
+winget install FFmpeg.FFmpeg
+```
+
+## Git Not Found
+
+**Error:** `git: command not found`
+
+**Solution:** Install Git from https://git-scm.com/downloads
+
+## No Commits Found
+
+**Error:** `No commits found in the specified branch`
+
+**Solutions:**
+- Verify the repository path is correct
+- Check if the branch exists: `git branch -a`
+- Ensure repository is not a shallow clone
+
+## Out of Memory
+
+**Error:** Process killed or memory errors
+
+**Solutions:**
+- Use `--sample-rate 10` to skip commits
+- Use `--max-commits 500` to limit commits
+- Use `--include "*.py"` to filter files
+
+## Permission Denied
+
+**Error:** Cannot write output file
+
+**Solution:** Check write permissions for output directory
+
+## Slow Performance
+
+**Solutions:**
+- Use `--workers 4` for parallel processing
+- Use `--sample-rate N` to skip commits
+- Use `--use-cache` for repeated runs
+
+## Still Having Issues?
+
+Open an issue at: https://github.com/user/git-chronoscope/issues