会話ログ2020-06-08
まずドキュメントがないか確認する
ガイドになるようなドキュメントをつくる
ソースコードを読んで理解しテストを書く
リファクタリングする
機能追加する
プロジェクトの内容を知らない人が参加しやすくなる
先日の「一人のプロジェクトが複数人のプロジェクトになるとよい」に関係してくる
他人を巻き込むためにはドキュメントが必要
アイデアを思いついた段階から、具体的にプロジェクトが進むにつれて、ドキュメントも具体的になる。
nishio.icon話そう
nisbot.iconあなたはこの会話で何が起きて欲しいですか?
nishio.icon噛み砕きタスクって具体的には何をすれば良いの?
nisbot.iconその噛み砕きタスクについて、他に何かありますか?
nishio.iconアイデアを噛み砕いて実行可能なアクションにする
nisbot.iconそのアクションについて、他に何かありますか?
nishio.iconこれがわからない状態の時に、どうすればわかるようになるのか?
nisbot.iconその状態について、他に何かありますか?
nishio.iconプロジェクトから離れてしばらく経ってるから、いろいろなことを忘れてると思う
nisbot.iconそのプロジェクトについて、他に何かありますか?
nishio.iconプロジェクトに関するドキュメントがあまり残ってない
nisbot.iconそのプロジェクトは、どんな種類のプロジェクトですか?
nishio.iconある程度の形にした後、放置されていたプロジェクト
nisbot.iconそのプロジェクトは、どこにありますか?
nishio.iconどこかのリポジトリにある
nisbot.iconそのリポジトリについて、他に何かありますか?
nishio.iconドキュメント書くべきだし、もしかしたら書いてあるかもしれないな
nisbot.icon
ある程度の形にした後、放置されていたプロジェクト
このプロジェクトは、どのあたりにありますか?
nishio.iconNG
nisbot.iconそのドキュメントは、どんな種類のドキュメントですか?
nishio.icon本当は、プロジェクトの内部の構造が記述されてて、それを読んだら新しい改善をする時にどこをいじれば良いかわかるのが理想
nisbot.iconあなたはそのプロジェクトをどう知るのですか?
nishio.iconドキュメントがあればそれを読めばいいんだけど、ないんだよね
nisbot.iconそのドキュメントについて、他に何かありますか?
nishio.iconソースコードを読みながら今から作るしかないか
nisbot.iconそのソースコードは、どんな種類のソースコードですか?
nishio.iconいろいろ実験をしながら作ったので奇怪な形をしてると思う
nisbot.iconその形について、他に何かありますか?
nishio.iconリファクタリングするのが良いのかもな
nisbot.iconドキュメントがあればそれを読めばいいんだけど、ないんだよね
あなたはこのドキュメントをどう知るのですか?
nishio.icon先日聞いた話としては、ソースコードに単語頻度解析をかけてそこからモデルを起こすと良さそう
nisbot.iconそのソースコードについて、他に何かありますか?
nishio.iconまずはドキュメントがあるのか確認して、ソースコードを読んでみなければ、具体的アクションに噛み砕けないか
nisbot.iconそのドキュメントは、どのあたりにありますか?
nishio.iconあるか、ないかわからないので確認する、これが最初のタスク
nisbot.iconそのタスクについて、他に何かありますか?
nishio.iconなければソースコードに単語頻度解析をかけるのが次のタスク
nisbot.iconそのタスクは、どんな種類のタスクですか?
nishio.iconソースコードの大まかなモデルを作るタスクだ
nisbot.iconあなたはそのソースコードをどう知るのですか?
nishio.icon読んで、機能を理解して、それから将来のリファクタリングに備えて理解した機能をテストコードにすると良い
nisbot.iconそのリファクタリングについて、他に何かありますか?
nishio.icon機能追加とは分けて実行すべき。リファクタリングが先で良い。なんかそれを表現した格言があったような…
nisbot.iconそのリファクタリングは、どんな種類のリファクタリングですか?
nishio.iconコードの挙動を変えずに、絡まったコードを綺麗な構造にして、新しい修正をやる時に悩まなくてもできるような形にすること
nisbot.iconその構造について、他に何かありますか?
nishio.iconシンプルにする
nisbot.iconソースコードの大まかなモデルを作るタスクだ
このソースコードは、どこにありますか?
nishio.iconNG
nisbot.icon
まずはドキュメントがあるのか確認して、ソースコードを読んでみなければ、具体的アクションに噛み砕けないか
このドキュメントは、何のようですか?
nishio.icon地図だ。どこへ行けば良いのかを指し示す大まかなガイドだ
nisbot.iconあなたが価値を感じているのは何ですか?
nishio.iconガイドがあればネクストアクションを決めるコストが下がる。これは価値だ。
nisbot.iconそのガイドは、どんな種類のガイドですか?
nishio.iconソースコード全体を読み直して理解し直さなくても、どこをどう修正したら良いかがわかるガイド
nisbot.iconそのガイドについて、他に何かありますか?
nishio.icon書籍の目次みたいなもの
nisbot.iconプロジェクトとソースコードの関係は何ですか?
nishio.iconソースコードは適切に更新されていくことで、脱皮を繰り返す蛇のように成長を続けていく、この生きているシステムがプロジェクト
nisbot.iconそのプロジェクトと、ソースコードとは同じですか?違いますか?
nishio.icon例えていうなら人間と肉体は同じか?って言ってるようなもので、死んだ人間も生きてる人間と同じ肉体を持っている
nisbot.iconプロジェクトの時、ソースコードに何が起こりますか?
nishio.icon更新される
nisbot.iconソースコードの時、プロジェクトに何が起こりますか?
nishio.icon新しいアイデアとかユーザの反応とかニーズとか、ソースコード以外の成長の糧がソースコードを動かすことによって生まれる
nisbot.iconそのソースコードとプロジェクトの間には何がありますか?
nishio.iconその話は置いといて「噛み砕きタスクって具体的には何をすれば良いの?」に関しては、まずドキュメントがないか確認する、次にソースコードの単語頻度解析をする、ガイドになるようなドキュメントをつくる、ソースコードを読んで理解しテストを書く、リファクタリングする、機能追加する、という流れでよいかな?
nisbot.iconそのガイドとプロジェクトの関係は何ですか?
nishio.iconプロジェクトの内容を知らない人や忘れた人がプロジェクトに参加しやすくするドキュメント。あ、そうか、先日の「一人のプロジェクトが複数人のプロジェクトになるとよい」に関係してくるのだな
nisbot.iconそのプロジェクトとドキュメントの関係は何ですか?
nishio.icon他人を巻き込むためにはドキュメントが必要、と。
nisbot.iconそのドキュメントと、プロジェクトとは同じですか?違いますか?
nishio.iconある意味、プロジェクトが続いていくためにはソースコードよりドキュメントの方が大事?
nisbot.iconそのプロジェクトの時、ドキュメントに何が起こりますか?
nishio.iconアイデアを思いついた段階から、具体的にプロジェクトが進むにつれて、ドキュメントも具体的になる。
nisbot.iconそのドキュメントの時、プロジェクトに何が起こりますか?
nishio.iconで、ドキュメントはプロジェクトが生き続けるための支えになるのだな
nisbot.iconそのプロジェクトは、何のようですか?
nishio.icon生物っぽい
nisbot.iconプロジェクトとドキュメントの間には何がありますか?
nishio.iconバイバイ