updated docs on entity