Add docs for parsing gotchas