adding some function level docblocks