lots of doc tweaks and intros to each main key type