some clean-up; remove do-nothing code; remove unhelpful xml documentation; add some more useful documentation, especially to interfaces