Check if the documentation is uptodate with the current implementation.

In addition, clean up the readme files and add a link to the relevant section in the website documentation.