- PR -

感想:第1回 アジャイル開発ではドキュメントを書かないって本当?

投稿者投稿内容
Jitta
ぬし
会議室デビュー日: 2002/07/05
投稿数: 6267
お住まい・勤務地: 兵庫県・海手
投稿日時: 2006-02-22 21:05
 むっちゃ読み易う、まとまっとう。最初からぶわーっ!と読み切ってしまえるくらい引きつけるし、例に出とうコードも、ようある「ありそうで使わんコード」やのうて「ホンマに使うてそうなコード」やし、井坂師匠が関西弁っちゅうのんが、良かったんかなぁ?
 つっこむな言われとうけど、井坂師匠の関西弁も、変なとこ少ない。せやけど、僕が読み易いっちゅうことは、世間一般で言う関西弁、つまり大阪弁やのうて、播州弁かもしれんなぁ?

 大事なところを青地に青で書いて、「選択して浮き上がらせろ」っちゅうのも、考えはったね。読むんに注目せなあかんもんな。
 ただただ、感心しながら読ませてもらいました。おおきに。ありがとう。
じゃんぬねっと
ぬし
会議室デビュー日: 2004/12/22
投稿数: 7811
お住まい・勤務地: 愛知県名古屋市
投稿日時: 2006-02-23 02:21
な、なんか会話の部分って NAgile に関係ないところばかりっすねw
外の人とか、筆者の事情を書いてしまうあたりが GJ。

とりあえず、「開発において最も大切なのはコミュニケーション」には同意です。
これがなされていないと、スケジュール管理すらままなりません。

それにしても、ソースコードで交換日記は私もやりましたね...
あと、ケンカしているのも見かけたことがあります。

/* 2002/xx/xx : 無意味な処理なので削除 by A begin>> */
/* 2002/xx/xx : ↑勝手に削除しないように by B */
/* 2002/xx/xx : 更新された側のクラス使ってないので問題ないでしょう? by A */
/* 2002/xx/xx : ↑次バージョンのために実験でおいてあるのよ by B */
/* 2002/xx/xx : だったらコメントアウトして理由書いておくべきでは? by A */
/* 2002/xx/xx : ↑だからって勝手に削除していい理由にはならんだろ by B */

記憶を頼ってますが、こんな流れだったような。
"同じ室内にいる" んだから、直接言いに行こうよ... orz

_________________
C# と VB.NET の入門サイト
じゃんぬねっと日誌
Amata
会議室デビュー日: 2005/12/22
投稿数: 1
投稿日時: 2006-02-23 09:30
おはようございます。
読み進めやすい文章構成を見てもAgileの片鱗を見た気がしますね。

コミュニケーション能力の重要さを身をもって感じる毎日なのですが、
周りの人にも勧めてみようと思いました。

引用:

Jittaさんの書き込み (2006-02-22 21:05) より:
 つっこむな言われとうけど、井坂師匠の関西弁も、変なとこ少ない。せやけど、僕が読み易いっちゅうことは、世間一般で言う関西弁、つまり大阪弁やのうて、播州弁かもしれんなぁ?



#個人的には播州弁はもっときつい口調な気がしますw (うちの地域だけかな・・・。)
#
#あと
# 「わやや*4がな」(*4 台無しな様子。)
#は
# 「わや*4やがな」(*4 台無しな様子。)
#な気がするとこっそり突っ込んでみたりします。

囚人
ぬし
会議室デビュー日: 2005/08/13
投稿数: 1019
投稿日時: 2006-02-23 11:44
引用:

それにしても、ソースコードで交換日記は私もやりましたね...
あと、ケンカしているのも見かけたことがあります。

/* 2002/xx/xx : 無意味な処理なので削除 by A begin>> */
/* 2002/xx/xx : ↑勝手に削除しないように by B */
/* 2002/xx/xx : 更新された側のクラス使ってないので問題ないでしょう? by A */
/* 2002/xx/xx : ↑次バージョンのために実験でおいてあるのよ by B */
/* 2002/xx/xx : だったらコメントアウトして理由書いておくべきでは? by A */
/* 2002/xx/xx : ↑だからって勝手に削除していい理由にはならんだろ by B */


笑った。

目の前にいるのにメールやメッセンジャーで伝える方もいらっしゃる。
文字になっていた方が便利な情報はそれでよし。
しかし「残業するなら申請出して」とかは声に出して伝え給え、と声を大にして伝え給いたい。

しかし、こんな話が出てくると、拡大解釈極論者がとんでもない事を言い出す。
「開発にとって最も大切なのはコミュニケーション」ではなく「開発にとって唯一大切なのはコミュニケーション」だと言わんばかりだ。
コミュニケーション、コミュニケーションと言葉を覚えたばかりの赤ん坊のように繰り返し、技術力はなおざりだ。

改めて言わなくてもコミュニケーション能力は、人間として「当然」「確実」に備えていなければならない能力ではなかろうか。それを土台に技術力が必要なのだ。いちいち言わなくてもコミュニケーション力は持っていて欲しい。
_________________
囚人のジレンマな日々
R・田中一郎
ぬし
会議室デビュー日: 2005/11/03
投稿数: 979
投稿日時: 2006-02-23 13:21
僕もこのシリーズは好きです。
読み終えると初心に帰ったような清清しい気持ちになって、より一層、
綺麗で読みやすいプログラミングを心がけようと思います。

で、3日で汚くなるわけですがorz
杏仁豆腐
常連さん
会議室デビュー日: 2003/10/04
投稿数: 48
お住まい・勤務地: あっち・なぜか平和だったところ(T_T)
投稿日時: 2006-02-23 13:32
うーん、あんまり良くないよなぁとか思いつつ、
英語→日本語 直訳みたいな冗長コメントは慣れない
新人さんに効果あったりするんで、結構書いてしまいます。

スポットでperlの修正なんかやると独特の省略記法が
バリバリだったりするとコメント欲しーと思うこともあるし、

インターフェースというか、この辺のコードの記法と
メンバーの慣れの収まりどころを早くまとめる方法が知りたいです。


コメントで交換日記は今のところ遭遇したことのない
ので一回くらいは見てみたい。


コミュニケーションとは離れるけど、printでデバッグで
きないようならコードを見直したほうが良いってのを
読んでて、ふと思い出した。

--------------
挿絵のノリがバラバラなのがなんでか、
すごーく気になります。

関西弁、解らないからつっこめない... ちょっと損した気分 orz
Jitta
ぬし
会議室デビュー日: 2002/07/05
投稿数: 6267
お住まい・勤務地: 兵庫県・海手
投稿日時: 2006-02-23 22:25
> #個人的には播州弁はもっときつい口調な気がしますw (うちの地域だけかな・・・。)
 JR の北か南かで言葉変わるから...

# 浜手の人に「播州弁にしては上品すぎる」と言われたことありσ(・_・)


 コメントで交換日記って。。。

 いや、マジで、やめましょう、洒落になんないから。
 2次請けをやっていたときの経験です。3次請けから“納品物”(と、表現しておきます)が上がってきました。ソースコードを眺めてびっくり!!

「こんな面倒なことさせやがって。もっと簡単な仕事だって聞いていたのに」

3次請け、4次請けの会社の社長が謝罪に来ましたが、3次請けとはそれから3年ほど、お付き合いがありませんでした。そのまま元請けに出していたり、出荷されていたら、いったいどうなっていたことか。。。
じゃんぬねっと
ぬし
会議室デビュー日: 2004/12/22
投稿数: 7811
お住まい・勤務地: 愛知県名古屋市
投稿日時: 2006-02-24 01:43
引用:

Jittaさんの書き込み (2006-02-23 22:25) より:

コメントで交換日記って。。。
いや、マジで、やめましょう、洒落になんないから。
2次請けをやっていたときの経験です。


フォローするわけじゃないですが、直接だったのでソース納品はなかったんですよね。
流石にそこまで常識(ry

引用:

3次請けから“納品物”(と、表現しておきます)が上がってきました。ソースコードを眺めてびっくり!!
「こんな面倒なことさせやがって。もっと簡単な仕事だって聞いていたのに」


げ、いるんだ... orz
実際に問題になるのはこういうのでしょうけど、それをさしおいても「直接言いに来なさい」

_________________
C# と VB.NET の入門サイト
じゃんぬねっと日誌

スキルアップ/キャリアアップ(JOB@IT)