massive documentation update
8 files changed