Merge pull request #13 from fvanderlinden/master

Removed legacy "failure" remarks in the usersguide
Update documentation and fixed illustration