このスレッドはアーカイブ化された過去ログです。
このスレッドはアーカイブ化された過去ログです。
人気のスレッド
難民
715
3778.1
7153778.1乃木坂469313574.2
9313574.2乃木坂469673444.3
9673444.3既婚女性1761032.6
1761032.6難民846993.4
846993.4市況1601889.8
601889.8乃木坂46232875
232875乃木坂46196721.9
196721.9乃木坂4679707.3
79707.3
ニュース速報+413609.7
413609.7もっと見る
■ 「正しく動く」だけでは意味がない
> 「コンピュータ言語は人間のための言語なのだから、人間が読んで分からない事柄には
> 人間の言葉で補足を加えねば意味がない」ということである。
意訳 ソースコードは人間が読めないから、日本語を書く
■ 上手なコメントを書くための心得
> リスト1が悪い例、リスト2がそれを修正した例である。これらを見ながら解説していこう。
リスト2 がクソすぎる
■ 不用意なカタカナ語禁止
> 「担当者」は英語でchargeというが分かりにくい。分かりにくいからコメントがいる。
> そうするくらいならローマ字でtantouと書いて済ませる方がよっぽどいい。
■ 冒頭に、自ファイル名を書け
■ 冒頭に、日付・連絡先を書け
■ 「マジックナンバー」の意味を書け
■ 同じ事でも、離れた所にはもう一度書け
DRY原則。同じことを複数書くな。同期が取れなくなる
■ 「別途資料参照」のみならず、内容も書け
■ if文条件も丁寧に書け
■ 英語綴りを間違えるな、自信がないならローマ字で
自信がないなら、SHI・RA・BE・RO☆
> 確かなことは、「人間にとって分かりやすい書き方」
意訳 俺たちはプログラマじゃない。素人なのでプログラミングのことはわからない
日本語プログラミング言語が羨ましい