ユニケージ流コメントの書き方が、ひどすぎて失笑 (7ﾚｽ)
ユニケージ流コメントの書き方が、ひどすぎて失笑 http://mevius.5ch.net/test/read.cgi/tech/1665802605/
上
下
前次
1-
新
通常表示
512ﾊﾞｲﾄ分割
ﾚｽ栞
抽出解除
必死ﾁｪｯｶｰ(本家)
(べ)
自ID
ﾚｽ栞
あぼーん
ﾘﾛｰﾄﾞ規制
です｡10分ほどで解除するので､
他のﾌﾞﾗｳｻﾞ
へ避難してください｡
1: デフォルトの名無しさん [sage] 2022/10/15(土) 11:56:45.81 ID:Va9+8zVB https://uec.usp-lab.com/JOURNAL/CGI/JOURNAL.CGI?POMPA=SAHOU_journal10 ■ 「正しく動く」だけでは意味がない > 「コンピュータ言語は人間のための言語なのだから、人間が読んで分からない事柄には > 人間の言葉で補足を加えねば意味がない」ということである。 意訳 ソースコードは人間が読めないから、日本語を書く ■ 上手なコメントを書くための心得 > リスト1が悪い例、リスト2がそれを修正した例である。これらを見ながら解説していこう。 リスト2 がクソすぎる ■ 不用意なカタカナ語禁止 > 「担当者」は英語でchargeというが分かりにくい。分かりにくいからコメントがいる。 > そうするくらいならローマ字でtantouと書いて済ませる方がよっぽどいい。 ■ 冒頭に、自ファイル名を書け ■ 冒頭に、日付・連絡先を書け ■ 「マジックナンバー」の意味を書け ■ 同じ事でも、離れた所にはもう一度書け DRY原則。同じことを複数書くな。同期が取れなくなる ■ 「別途資料参照」のみならず、内容も書け ■ if文条件も丁寧に書け ■ 英語綴りを間違えるな、自信がないならローマ字で 自信がないなら、SHI・RA・BE・RO☆ > 確かなことは、「人間にとって分かりやすい書き方」 意訳 俺たちはプログラマじゃない。素人なのでプログラミングのことはわからない 日本語プログラミング言語が羨ましい http://mevius.5ch.net/test/read.cgi/tech/1665802605/1
ﾒﾓ帳
(0/65535文字)
上
下
前次
1-
新
書
関
写
板
覧
索
設
栞
歴
ｽﾚ情報
赤ﾚｽ抽出
画像ﾚｽ抽出
歴の未読ｽﾚ
AAｻﾑﾈｲﾙ
Google検索
Wikipedia
ぬこの手
ぬこTOP
0.010s