more docs and todos