Tone down some of the asserts because they can be triggered in normal
operation. Some basic documentation for the various classes.