more outline, starting to write docs