Improvements of user docs, examples and tests