documentation

* readme.md in the /doc folder so github has an index (copy of home.md)
* added the API docs
* updated FAQ

please have a look at the wiki on github and let me know which other docs should be included in /doc and leave this pull request open in the meantime