expand on docs description of identity

closes #38