dev: updated docblocks