Updated tutorial and documentation

This incorporates Iain Nicol's suggestions