cleaned up documents. idl is the authority