modifies interoperability document to make it clearer to generate