adjust the readme

There are some broken links in the readme. There are also some sections under construction, which should be written more properly.