added additional comments to current methods