merge documentation efforts

fixed broken links