conversion to markdown complete. updating order of docs and tweaking most of them.