外部とのやりとりのプロトコルは公開したほうが吉かと
批評してもらえるし

プロトコル仕様レベルになれば、厨は口出せないので
面倒なことにはならないだろうし

運が良いと、よりキレイなドキュメントにしてくれる人が
現れるかもしれないし