some cleanup and documentation of *Operation classes