add usefull usage information to the documentation