document some more