documentation - 通信プロトコルの指定

Question

私は、今日かなり悪い特定の2つの既存のシステム間の通信を文書化しようとしています。使用できるネットワーク通信プロトコルを文書化するための標準またはベストプラクティスはありますか？文書化する必要のあるいくつかの特別なタイプと混合ビット順序があります

通信はとても簡単で、こんな感じです（擬似コード）

システムA->システムB（通信を開始）

  short type;                   //Little endian

システムB->システムA

  short type;                   //Little endian
  short count;                  //Little endian
  //Start time
  short NoOfDaysSince1970;      //Big endian
  int   noOfMillisecoundsToday; //Big ending
  if(type==1)
    for(int i=0;i<count;i++)
      char[20] name;
  else
    for(int i=0;i<count;i++)
      float value;    //platform specific float, Little ending
    for(int i=0;i<count;i++)
      short flag;                //Big ending
  //Stop time
  short noOfDaysSince1970;       //Big ending
  int   noOfMillisecoundsToday;  //Big ending

Answer 1

Abstract SyntaxNotationOneをご覧になるかもしれません。