document some things missed before