document all the things. except for the undocumented things