update documentation. reword joke and todo