moved most of the readme into the main doc for clarity