adds more details and links to the documentation