more comments on methods for clarity