update readme

README.md

@@ -1 +1,67 @@
-# mstch [![Build Status](https://travis-ci.org/no1msd/mstch.svg?branch=master)](https://travis-ci.org/no1msd/mstch)
+# mstch - {{mustache}} templates in C++11 
+
+mstch is a complete implementation of [{{mustache}}](http://mustache.github.io/) templates using modern C++.
+[![Build Status](https://travis-ci.org/no1msd/mstch.svg?branch=master)](https://travis-ci.org/no1msd/mstch)
+
+## Basic usage
+
+```c++
+#include <iostream>
+
+#include <mstch/mstch.hpp>
+
+int main() {
+  std::string view{"{{#names}}Hi {{name}}!\n{{/names}}"};
+  mstch::map context{
+    {"names", mstch::array{
+      mstch::map{{"name", std::string{"Chris"}},
+      mstch::map{{"name", std::string{"Mark"}},
+      mstch::map{{"name", std::string{"Scott"}},
+    }
+  };
+  
+  std::cout << mstch::render(view, context) << std::endl;
+  
+  return 0;
+}
+
+```
+
+The output of this example will be:
+
+```
+Hi chris!
+Hi mark!
+Hi scott!
+```
+
+## Requirements
+
+ - A C++ compiler with decent C++11 support. Currently only tested with GCC 4.9.
+ - Boost 1.54
+ - CMake for building
+
+## Building
+
+From the root of the source tree:
+
+```bash
+ $ mkdir build
+ $ cd build
+ $ cmake ..
+ $ make
+```
+
+Building with unit tests:
+
+```bash
+ $ mkdir build
+ $ cd build
+ $ cmake -DWITH_UNIT_TESTS=ON ..
+ $ make
+ $ make test
+```
+
+### Advanced usage
+
+TODO