fixed docu
docu and adapt the user-action messages
docu