add comments in some Object entity methods