improve documentation, especially of the widgets