a few comments on a few of the classes and definitions would be nice