Adding new docs to yaml and fixing broken links