update docs wrt identifiers