A few modifications and comments

I just finished reading through the paper. I did a few modifications and added a few comments in brackets [emma:...]. My main suggestion is about adding a "Getting started" section so that there is some code early in the paper (typically on page 1, if the reader wants to know quickly whether the API is nice or not).