added documentation for new method