fixes for #31

I updated some docs, and runner. Please check the docs for correctness.