add glossary
add notes on how to treat repo objects
annotate join timeout unit
add some more glossary links