update docs and todos