major documentation update