documentation lest we forget