[B! コメント][Programmer] atsushifxのブックマーク

atsushifx id:atsushifx

コメントとProgrammerに関するatsushifxのブックマーク (3)

プログラムにコメント書かない文化もあるよって話｜NZ MoyaSystem
以下の記事を読んで。 530000micro.hatena blog.com 僕が勤めている会社では、原則、プログラムにコメントを書かないのがルールです。人生で初めてプログラムに触れてからこのかた、プログラムには必ずコメントを書けと指導されて来ましたし、自分自身も、後輩たちにちゃんとコメント書けよと言い聞かせてきました。そんなわけで、最初に全然コメントのないソースコードの山を見たときは、正直「ゲッ、なんじゃこりゃ……」と面食らったのは確かです。ところが、「なぜうちのプログラムにはコメントがないのか？」と同僚に尋ねてみると、実に納得の行く回答が返ってきたのでした。なぜコメントが必要なプログラムを書くのか？同僚いわく、「コメントが無くても読めるようなプログラムを書け」という思想が根底にあるのだそう。適切に関数や変数が命名され、スコープがきちんと管理され、ロジックの流れが整理されているコ
atsushifx 2016/04/22
原則コメントを書かないであって、まったく書かないわけではない。問題はコメントを含むドキュメントと実際のコードの乖離であって、必要なコメントは書くべき。ここらへんはアジャイルでのドキュメントレスと一緒

Programming

Programmer

品質管理

Coding

アジャイル

コメント
リンク
【プログラミング】退職した先輩が書き残していったコメントがひどすぎる・・・ - 意識低い系ドットコム
こんにちは、意識低い系サラリーマンのKENです。今回は零細IT企業でシステムエンジニアをしている僕が遭遇した酷いコメントについて。猫でもわかるC#プログラミング第3版 (猫でもわかるプログラミング) 作者: 粂井康孝出版社/メーカー: SBクリエイティブ発売日: 2016/02/27 メディア: 単行本この商品を含むブログ (2件) を見る通常プログラムを組むときは、プログラミング言語を使ってソースコードを書いていきます。でもプログラミング言語だけでひたすら書いていると、第三者が読んだときや後から自分で見返したときにわかりづらいので、「コメント」と呼ばれるメモ書きを付記することがあります。あります、というかほとんどの人はそうします。例えば、「C#」というプログラミング言語だと、行の先頭に「//」と打つと、その行はプログラムの一部としては解釈されず、単なるメモ書きとコンピュー
atsushifx 2016/04/21
全然ひどくない。ひどいコメント、プログラムなら、まずCプログラミング診断室 http://www.pro.or.jp/~fuji/mybooks/cdiag/を読んでから

Progarmming

コメント

programmer
リンク
まとめよう、あつまろう - Togetter
コミュニケーションが生まれるツイートまとめツール
atsushifx 2013/01/09
この人たちにコミュニケーション能力があるとは思えない。BioからするとSIerのSEのようなんだけど、分かってくれないのをプログラマーのせいにしているならコミュニケーション能力にかなりの疑問がつく

SIer

ITエンジニア

programmer
リンク
1