update of content

cleaning it up, providing links, making it less generic