Review main README

There are some broken links because I have to supply the
detail pages, but a part from that I think this is finished.