documentation for some methods