updating the markdwon with some links and trying to keep references in a compendium style