update docs so they can be run locally again
add additional information