additional documentation for methods