improve the documentation

I found it difficult to find information on how to add options, maybe this can help
Merge pull request #99 from guillaumevincent/patch-1

improve the documentation