title: Tool for protocol or interface description
body: <p>We have to develop a protocol as a interface description between different systems in different companies. The implementations will be made in different languages (not known) by the developers in each company.</p>
  
  <p>However, we want to develop the protocol on a textual description base together. I will have the base copy of the current version and want to send it out to all for comments.</p>
  
  <p><strong>What is a good tool to do so?</strong></p>
  
  <p>At the moment we are using MS Word what leads to several problems:</p>
  
  <ul>
  <li>We need a lot of time for text formatting things.</li>
  <li>Its not possible to reference to a datatype in the methods description.</li>
  <li>The wording differs from chapter to chapter (different authors) and is hard to align.</li>
  </ul>
  
  <p>Perfect would be:</p>
  
  <ul>
  <li>A tool with a glossary and auto-completion.</li>
  <li>References to other items (methods, data types, ...) with active links.</li>
  <li>Automatic generation of a human-readable (PDF-) document.</li>
  </ul>
  
  <p><strong>Do you know such a tool?</strong></p>
  
  <p>PS: I did not get Sparx Systems Enterprise Architect doing the job. Maybe also hints for this one?</p>