full documentation update