update README and markov/warp docstrings