documentation of some methods that I forgot last night