I agree, and am working on refactoring how that's done.  In the meantime though this basically documents how they existing code is implemented so that other developers can copy it.  I'm working on simplifying things so that fewer "internal" details need to be worried about, but that will have to wait til later.