[methods] general notes additions