2011-01-23

http://anond.hatelabo.jp/20110123172736

程度問題だけど

ドキュメントコメントについては、それも設計・実装の内という認識。あって当然。無いのが異常。

業務できれいなドキュメントが、10年残っているというのをウォーターフォール以外ではあまりみない。

時間があれば、そら、やったほうがいいけど、日本だとドキュメント更新されていないケースもよく見る。 よく見るんだからそら、対応する。

個人的には、リバースで作られていないドキュメントは、古い可能性があるので鼻から信用しない。ヘッダ見る派

 

件の後輩にとっては、そうではなかったって事だ!

そんな天才なら好きにやらせた方がいいよ。

じゃぁ、OpenSSLなんて、書いてないで会社にとって差別化要因になって、金を稼げる方をやってくれ。

 

書くなといってるんじゃない。それが、どういう会社メリットに繋がっているのか? 速度・メンテナンス・可読性 ちゃんと検討したか?

という話。

基本的に書いたら、10年ぐらい使われて、10年後には新人メンテナンスしてるんだから、そこまで考えたか?って話。

考えてあって、ドキュメント完璧で、保守性も完璧・・・

 

うん、それはいいけど、教育コストは考えた? そこまで考えた上で、書き下ろしのほうが会社にとって金を生むという判断ができるようなものなら、

そら、それでいいんじゃない?という話。

 

 

大切な事は、他人がメンテナンス出来ないコードというのは、書いた人間が天才なんじゃない。単に他人のことを考えずに書いただけ。そこを考えようという話。 

記事への反応 -
  • ソースコードのレビューをした。 あー、オシイなぁ、すごい優秀なんだけどなぁ・・・ オープンソースの読み込みが足りないなぁ。それ、わざわざ自分で書かなくても、有名なオープン...

    • ケーズバイケースなのは大前提として。 能力があるなら自分で書けばいいと思う派。   ・実装工数<テスト工数。逆転する奴は優秀では無いよね。 で、オープンソースでテストを省け...

      • 自分だけが使うなら、何でもいいんだけど・・・他人も使うからね。 たとえば、新入社員がそのコードを引き継いだとして ドキュメントやマニュアルが揃っていて、いざとなったら、コ...

        • 新入社員に引き継がせるなら、質問は社内でやらせたい派。 そりゃ、勝手に社外のコミュニティで訊いて解決してくれれば先輩の手間はかからないけど、 業務の一環の中で、先輩の知ら...

          • 程度問題だけど ドキュメント・コメントについては、それも設計・実装の内という認識。あって当然。無いのが異常。 業務できれいなドキュメントが、10年残っているというのをウ...

            • 業務できれいなドキュメントが、10年残っているというのをウォーターフォール以外ではあまりみない。 10年前の話じゃなくて、今の話をしてるんだよね? 10年前のプログラム...

              • 新人が「レビューしてください」つってモノを持ってきた、でも内部設計書が無い、ってのは昨今ありえないな。 そうじゃない。書いたものを10年間 更新し続けられるか?って話...

                • 時間と予算がある初期開発では作られるが、あとあとの予算がなかったり急だったりしたときに入るメンテナンスで変更が入って、ドキュメントが置いて行かれるってのはよくある話。...

                  • 途中のバージョンからドキュメントが雑になったりスカスカになったりするかもしれない。 よくわからんが、そのとおりだろ。同じことを言ってる。 だから、危険性は同じで、どう考...

                    • あたりまえだが、そんなコメント出す段階で、その部分のドキュメントに多くのコストを掛ける金はない。 あったら、そういうコメントにはならん。 他方 オープンソースはOpenSSLク...

                      • 完全横だけど 後輩の事が嫌いなんだろうよ 仕事ができないから嫌いと人物が嫌いって 分けているようで分けてなかったりする

                        • 意味がわからん、 嫌いだったら、 おいいね。っつっといて、こっちで直して。 1年ぐらいでさようならだろ。普通。 嫌いだったら、手間隙かけて、わざわざ コメントして 伸ば...

                          • 具体例として、OpenSSLなら、実際に作るよりも、使ったほうが早い場合のほうが多いし、今回はそうだろう。という話だよ。 今回の話はそうじゃないよ。後輩はもう実装物を持ってきた...

                            • よくわからんが、後輩が作ったものを使わなくちゃいけないという理由はどこにもない。 よければ使う、悪ければ、よくなるまで治すか、他のものを使ってもらう。   今回は、ドキュ...

                              • よくわからんが、後輩が作ったものを使わなくちゃいけないという理由はどこにもない。 できれば、よくわかった上で発言してくれると嬉しい。   さて、元増田が「オープンソース...

        • テストのコストを含め結局仕様を満たすためにかかるコストがどうだって話なんだから オープンソースを使う=正ってのはありえない 元増田がオープンソース信者なのだけはわかった

          • 元増田がオープンソース信者なのだけはわかった そんな事はどこにも書いていないんだが? 両極端すぎるんじゃない? ちゃんと、テストして、自分でコード書き起こして ベンチマ...

        • これを書いて小休止ですか

        • 名前でぐぐってみたけど、君のプロジェクトなくなったの?

    • このエントリ気になるなあ。 ある要求を実現するにはどのような技術を用いるか、オプソがあるならどれを使うか、どの範囲を我々がコードするか、事前に経験豊富な(はずの)SEが決め...

      • 元増田ですが・・・自分ならw Zend Frameworkは捨てる。 他人に言うなら、Zend Framework使ったほうがいいんじゃない?という確率のほうが高いと思われる。(相手にもよる)   こういう言...

        • コードレビュー? そらもう、レビュアー「これなんでこうなってんだっけ?」レビュイー「○×△だからよ」レビュアー「あーなるほど or これもっとこうしてよ」の繰り返しの作業でし...

    • 免責条項や瑕疵担保責任を考えたらオープンソースなんて使えたもんじゃないんじゃないの? まあ、販売用や受託開発だったらって話だけど・・・

      • 免責条項や瑕疵担保責任っていうけど、 サービスや商品だから 売れる時期ってあるよね。 治しますけど1年後じゃ意味が無い。 自社でつくろうと、外注でつくろうと オープンソ...

    • つまり、惜しいのは私だから、元増田を書くわけだが?   自分が書いた元増田を読んでみ。最初の奴。 ソースコードのレビューをした。 あー、オシイなぁ、すごい優秀なんだけど...

      • 増田じゃ無く、レビュー書に書こう。 そのとおりだね。実際の会社では実際の会社のやりとりに従って、粛々と進めていくよね。 「あんたのお話、おかしいよ」って言ってるだけ。 ...

記事への反応(ブックマークコメント)

ログイン ユーザー登録
ようこそ ゲスト さん