adding documentation for add* methods