How do most companies define and manage message format specifications? Is it common for companies to create custom tools for creating and working with these documents?
At work we have a lot of systems that communicate via UDP messages. Each system has its own Interface Control Document (in Word or in HTML) which describes its message scheme. The documents have descriptions of each message along with its fields, and usage notes.
We're looking to standardize the format of these ICDs and write some tools that help create them. I was thinking we should create an ICD schema, and define the ICDs in some data-interchange format (XML, JSON, protobuf). Then we could create parsers that generate human-readable documentation (HTML, PDF), or even message parsing code (where useful and appropriate).
I don't want to reinvent the wheel, and I don't want to get too carried away. Does the above proposal sound reasonable?