コメント研究すれ。

**デフォルトの名無しさん** · 2008/03/20(木) 04:03:47

Ｃ言語でコメントを書く時とても迷うよな？

・見易さ
・書き易さ
・分かり易さ
・一貫性（統一性）
・とどけこの思い

とか、何でもいいからいい感じのコメントの書き方を考えませう。

**デフォルトの名無しさん** · 2014/11/09(日) 06:53:10.50

コメントは見出しみたいな物だ。何をしてるのか１行で自然言語で書かれていればソースコードのみより
明らかに読みやすい。

**デフォルトの名無しさん** · 2014/11/09(日) 09:44:07.78

>>155
実際それが目的なんだけどな
コピペが放置されてたり、そもそもコメントが無かったりで
「毎行コメント書くべし」なんてルールが出来て、
こんなコメントが量産される訳だ

i++;　//ループカウンタをインクリメント

**デフォルトの名無しさん** · 2014/11/09(日) 09:50:25.62

某でかいとこの案件で、毎行コメント書けって言われて
無能しかいねーんだなと思ったな。

**デフォルトの名無しさん** · 2014/11/09(日) 10:02:14.16

まあ、デカいとこになるとさ、エンジニアではない有象無象のオペレータ向けの
ルールにせざるを得なくなるから仕方ないのかな～とは思うけど、
やっかいなのはこういうデカイとこ特有のくだらないルールを見て
何でも右習えでドヤ顔で小規模チームにも適用したがるアホなマネージャ連中だ

出来る人向けのルールとしては、GoogleのC++のが結構参考になる、かな？
あそこは例外禁止だけど

**デフォルトの名無しさん** · 2014/11/09(日) 10:05:41.82

以前に毎行コメント書けなんて言うデカいところのコードレビューで、
「構造体は代入出来ないからmemcpyで書き直せ」なんて言われちったよ

レビュアーがこういうレベルだから変なルールを作らないといけないのか
変なルールで固めて考えさせないから、こういうレベルに育ってしまうのかね…

**デフォルトの名無しさん** · 2014/11/24(月) 01:07:35.04

/* テスト　*/

**デフォルトの名無しさん** · 2015/02/28(土) 08:46:56.17

エレメンタルプログラミングのすゝめ
ttp://takeshik.org/blog/2015/02/28/elemental-programming/

**デフォルトの名無しさん** · 2015/03/28(土) 18:43:37.83

>>161
けっこう面白い

**デフォルトの名無しさん** · 2015/09/25(金) 08:17:05.49

>>156
何のカウンタなんだよw

**デフォルトの名無しさん** · 2016/01/27(水) 20:50:32.13

コードをそのまま言葉にしただけのコメントは可読性を下げるだけだな。

**デフォルトの名無しさん** · 2016/10/08(土) 08:50:39.94

コメントって難しい

**デフォルトの名無しさん** · 2016/10/10(月) 14:22:13.01

>>164 コードをそのまま言葉にしただけのコメントは可読性を下げるだけだな。
激しく同意する。

コメントは概要を知らせるもの。詳細についてはソースを見ればよい。ソース全部を見
渡す前に迅速にそのコードの概要を知らしめるコメントであるべき。

**デフォルトの名無しさん** · 2016/11/02(水) 08:53:02.08

>>156
ひどいルールだな