method documentation update