added documentation to new methods used for gathering