- docs:
    - added docs on new lookup option that allows users to controll errors