small improvements for the tutorial
tested anton's scripts and added some rudimentary docs