documentation and todo updates