updated idl docs removed some lingering TODOs