documenting and cleaning up interop framework