moving some docs into README and others under docs/, removing redundant or out of date docs for #179.