diff --git a/README.md b/README.md
index 4826aa37..3261f2b3 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,8 @@
 ![Package Managers](https://img.shields.io/badge/package%20managers-SwiftPM-yellow.svg)
 [![license](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/yonaskolb/SwagGen/blob/master/LICENSE)
 
-A command line tool that generates an Xcode project from a YAML project spec
+A command line tool that generates your Xcode project from a YAML project spec and your folder structure. 
+This allows for easy configuration which is git friendly, and means your project structure represents exacty what's on disk. The project can be re-generated on demand which means you can remove your xcode project from git and say goodbye to .xcodeproj merge conflicts!
 
 Given the following spec file:
 ```yaml