added documentation on a function