[Momonga-devel.ja:00035] Re: プロジェクトのメンバー内で開発について語り合っている場の公開希望

["Yasumasa Ashida" <asip@xxxxxxxxxxxxx>]

ASIPです。

> > > むらけんです。
> >
> > むらけんさん、はじめまして。
>
> うぅ... users.ja#00006 でお話ししたと思うのですが(TT
> いや、僕も物忘れが激しい方なので文句言えませんね。

すみません、すっかり忘れてました。以後、気を付けます。

> > これから開発に参加しようと言う人のことも考慮にいれたほうがよいと思いま
す。
> > 自分(あるいは自分たち)さえわかっていればいいというのはどうかと思います。
>
> zoe さんへの返信でも書きましたが、自分にとって自明な事が、自明
> でないかどうかを判断するのは非常に難しいと思うのですが、その辺
> はどう考えてますか？
>
> 例えば、非常に極端すぎる例ですが、
>
>    gtk_init(&argc, &argv);
>
> この関数は Gtk+ を用いたプログラムでは良く使いますよね？常識み
> たいな物です。Gtk+ を知らない人にとっては常識じゃないんですよ
> ね。Gtk+ を使って開発をしている人は、Gtk+ を知らない人の事まで
> 考えてプログラムを書いているでしょうか？
>
> > CVSでコードを見るにしても、何らかの捕捉資料(メモ程度のもの)があれば
> > より短期間でソースの中身を理解できると思うのですがいかがでしょうか？
>
> これも同じ事だと考えています。開発者にとってメモする程のことで
> もない場合は、コメントすら書かれていないですよね。
>
> > "CVSのコードを見ればわかる"というだけではこれから開発に参加しようかな
> > と思っている人でも二の足を踏むと思います。
>
> そうなんですが、開発に参加しようとしている以上は、ある程度の知
> 識は必要です。

ある程度の知識が必要なのはわかっています。
補足資料のはじめに"ＸＸの知識が前提として必要です。"とでも付けておけばそれで
事足りる
のではないでしょうか？

補足資料を読む上で最低限必要な知識については読む側が勉強すべきことです。

開発者が自明であると思う部分については別に書かなくてもいいと思います。

"開発者が自明であると思う"箇所について頻繁に質問が出るようであれば、
改訂を考える必要があるとは思います。

　Momonga（あるいはKondara)独自でカスタマイズしている部分について
の説明がある程度、補足資料に書いてあればいいのです。メモ程度でも
構わないと考えます。

/**------------------------------------------
ASIP(Yasumasa Ashida)
 @mail: asip@xxxxxxxxxxxxx
 @diary: http://asip.tdiary.net
------------------------------------------**/