large documentation update