addressed comments (added documentation)