rename introspectOr and add a bit more docs