add comments for some methods