Improving documentation

Hi there,
I've improved the english in the documentation. It's far from being perfect, I may do a second pass later, but it will do the job for now ;)
I've added a full working example too, based on the Java tutorial.
Thanks for your work !

Cheers,