document a gotcha