added run script and improve docs