document some methods