added a gotcha section to the docs