update documentation on documentation and other bits of documentation