document all the things!