add notes about methods to possibly be removed soon