better docs and now markdown