document some things