update documentation. tweak scripts