DOC: fill out link to gotchas