Skip to content

デモの「期待されるビヘイビア」を文章化する #1526

@k-okada

Description

@k-okada

今更ですが,

デモの出力(ロボットの行動、tweet、日記メール、resultメール)に関する明確な仕様がほしいです。

の指摘はナルホドで,明確な仕様とまではいかないけど,期待される結果レベルの記述はあるとよいとおもいます。
Fetchのキッチンデモだと,
https://github.com/jsk-ros-pkg/jsk_robot/tree/master/jsk_fetch_robot/jsk_fetch_startup/apps/go_to_kitchen
にReadMe.md 作って
https://github.com/jsk-ros-pkg/jsk_robot/tree/master/jsk_fetch_robot/jsk_fetch_startup
からリンク張るのかな。

で,イメージとしては

ぐらいの簡単なもので良いでしょう。https://github.com/jsk-ros-pkg/jsk_demos/tree/master/jsk_2013_04_pr2_610 みたいな感じです。

で,これで確認したいのは,

1)そもそも,どういうデモになっているか?最近は動いた,だけでなくて,データがアップロードされたり通知されている。今後は,その結果をさらに処理するバックエンドがポイントだと思うけど,どういうデモでどういうデータが作られているか,理解するのに役に立ちそう。

2)複数の機能が提供されているけど,なんか重複していないか?という事を,視覚化して確認できる。例えばメールが二種類やってくる,メールとTwitterで似たような情報を流している,あるいは,Twitterにも何をしているときの写真か説明文を入れたい,等々。今あるコードを今すぐ変える必要はないけど,新しいロボットで新しく作ろうと思ったとき,あるいは,同じようなコンテンツで別のコミュニケーションを行いと思ったとき,は,0から作るのではなく,既存の機能の拡張を考える。

3)2,3個のデモでこういう文章があると,それぞれのデモ間で,機能の説明が重複していないか?という事を確認できる。違うロボットで同じようなメールを流しているけど,違うページに説明がある場合は,共通のシステムにするチャンス。各ロボットのデモの説明は写真をはって,詳細はこちら→ と,共通パッケージへのリンクになっていると,複数のロボットで使えるようなシステムになっているという証拠になる。

取り合ず,これでどうなるかgo_to_kitchen でやってみましょう @708yamaguchi @tkmtnt7000 @mqcmd196 ....

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions