reorganize docs to put good stuff at the top and reuse/improve readme
reorganize docs to put good stuff at the top and reuse/improve readme
fixing merge conflicts