Update documentation for 1.2

Some parts, like the callback mechanism, are not properly documented yet. This should be done before releasing version 1.2