modified methods to be more self-documenting