First README documentation

Author: leobalter

README.md

@@ -1,6 +1,88 @@
 ArteJS [![Build Status](https://secure.travis-ci.org/vistaprint/ArteJS.png?branch=master)](http://travis-ci.org/vistaprint/ArteJS)
 ======
 
-ArteJS is a powerful, extensible, configurable, flexible and cross-browser rich text editor with a simple API that produces consistent, valid and concise html.
+[ArteJS](http://vistaprint.github.io/ArteJS/ "ArteJS Examples / Documentation") is a powerful, extensible, configurable, flexible and cross-browser rich text editor with a simple API that produces consistent, valid and concise html.
 
-[ArteJS Examples / Documentation](http://vistaprint.github.io/ArteJS/ "ArteJS Examples / Documentation")
+## Development
+
+The development of this project requires [git](http://www.git-scm.com/), [NodeJS](http://nodejs.org/) or [iojs](https://iojs.org/en/index.html), and [Grunt](http://gruntjs.com/) to be installed.
+
+To install Grunt:
+
+```sh
+npm install -g grunt-cli
+```
+
+You might wanna clone this project:
+
+```sh
+git clone [email protected]:vistaprint/ArteJS.git
+cd ArteJS
+```
+
+And install its dependencies:
+
+
+```
+npm install
+```
+
+### Building and Testing
+
+To build and check everything, just run:
+
+```
+grunt
+```
+
+Grunt will run checking and build tasks. This will also run the basic unit tests. To run all the tests on this project, you need to run:
+
+```sh
+grunt qunit:all
+```
+
+Or open `tests/all.html` in a browser.
+
+### Branches and commits
+
+For everything you change, please create a new branch before commiting, you can also reference an existing issue by prefixing it's number:
+
+```sh
+git checkout -b 17-fix-unit-tests
+```
+
+Remember to not commit directly into the master branch.
+
+If some commit fixes or references an issue, say it into the commit message, e.g.:
+
+```
+Implement the unit tests
+
+Fixes #17
+```
+
+## API
+
+To use ArteJS in your project, you need to bring load in your page:
+
+- jQuery 1.7.3 up to 1.9.1 (1.10+ support is current in progress).
+- `dist/rangy.js`
+- or `dist/arte.js` or the minified version `dist/arte.min.js`
+
+Example:
+
+```html
+<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js"></script>
+<script src="dist/rangy.js"></script>
+<script src="dist/arte.min.js"></script>
+```
+
+Then, you just call it in your JS:
+
+```js
+jQuery(function($) {
+    var arte = $('#my-editor').Arte();
+});
+```
+
+For more examples and further documentation, checkout our [home page](http://vistaprint.github.io/ArteJS/ "ArteJS Examples / Documentation").