Documentation update and important bugfix for % identity calculation