further update of docs