このスレッドはアーカイブ化された過去ログです。
このスレッドはアーカイブ化された過去ログです。
人気のスレッド
既婚女性
964
11878.2
96411878.2
ニュース速報+372176.2
372176.2難民7831873.7
7831873.7乃木坂46371713.2
371713.2乃木坂46121288
121288乃木坂468161178.7
8161178.7乃木坂46471158.6
471158.6乃木坂46791063.3
791063.3
ニュース速報+2041028.1
2041028.1乃木坂46574895.9
574895.9もっと見る
動作に差し支えのない範囲でコメントを残すことだ。
そこに、次の情報を含める。
・ このファイルの名前
・ このファイルの概要（何をするものかを簡潔に）
・ 最終編集時に施した修正内容
・ 最終編集者（最終編集者以外は書かない）
・ 最終編集日（最終編集日以外は書かない）
■ソースファイルなどの冒頭に記すべきコメントの例
#######################################
#
# プログラムや設定ファイルの名
# そのプログラムの概要
#
# その他のコメント……
# ・このリビジョンで何をしたのか
#
# Written by 最終編集者on 最終編集日
#
#######################################
プログラムの途中にコメントを残すのもよいが、冒頭にも残す。
途中に書いてあるだけでは、書いてある場所を探すのが手間だ。
また、最終編集した際の日付と人（メールアドレスなど）も記す。
長年経った時に、そのリビジョンをいつ誰が作成したのか把握するためだ。それが他人であった場合、
わからないことがあればその者に聞けばいい。だたし、複数人で手を入れていたとして、
最終編集者でない者の名前や日付を残す必要はないし、むしろ消すべきだ。
歴代の担当者が知りたくば、リポジトリーに残っている過去のリビジョンを見れば済む。
同様の理由で、修正前のコードをコメントアウトした状態で残す悪習も止めること。