improved docs on running