Enhance documentation with feature guides and troubleshooting

While the README covers basic installation and syntax highlights, more comprehensive documentation would help new users get the most from the plugin.

**Proposed Changes:**
- Add comprehensive feature guide with screenshots for each plugin feature
- Create troubleshooting guide for common issues
- Add configuration examples for different use cases
- Document the plugin's architecture for contributors
- Create video tutorials or GIFs showing workflow examples
- Add FAQ section addressing common questions

**Benefits:**
- Reduces support burden through self-service documentation
- Helps new users understand all available features
- Improves contributor onboarding
- Better SEO and discoverability

**Related Code:**
Update `README.md` and create additional documentation files in `docs/` directory.