update changes
todo: further improve docs for example scripts