Conversation

Notices

1. monaca :nikukyu: (mimoo@omochi.xyz@omochi.xyz)'s status on Wednesday, 05-Sep-2018 12:42:54 JST monaca :nikukyu:

   • せのお (妹尾 賢)

   ソースコメントしっかり書けばドキュメント代用になる…というのもわかるしアリだと思うけど、ソース中に書かれたコメントを最新仕様に合わせて更新するという作業はやはり発生するし、一般的なフォーマットで書かれたドキュメントやwikiをメンテするより難易度高いと思ってる。(ソースコメントは実作業レベルでコードを書ける人以外あまり読まない、いじれない領域だから、チーム内でその作業をやれる人間が限られてくる)

   • クマノテツ :m4_logo_wh: :sabacan: and Satoshi Kojima repeated this.