massive documentation update