minor changes: improve console messages
update documentation with last changes