Rabbit Slide Show

SEゼミ2015 - OSS Hack 4 Beginners - フィードバック

2015-06-27

Description

2015年のSEゼミの「プログラミングが好きな学生のための勉強会 - OSS Hack 4 Beginners」でのフィードバックの送り方の説明。

Text

Page: 1

フィードバック
須藤功平
株式会社クリアコード
SEゼミ2015 - OSS Hack 4 Beginners
2015-06-27
フィードバック
Powered by Rabbit 2.1.7

Page: 2

目的の確認
参加者の
OSS開発参加への
不安を払拭
フィードバック
Powered by Rabbit 2.1.7

Page: 3

現状確認
✓ 動かした?
✓ インストールはできた?
✓ ドキュメント通り実行できた?
✓ 開発用にインストールした?
✓ テストを実行した?
✓ 楽しんだ?
フィードバック
Powered by Rabbit 2.1.7

Page: 4

フィードバック
✓ メモが溜まっているはず
✓ 不備があることを書いたやつ
✓ うまくいかないことを書いたやつ
✓ upstream(開発元)に報告
フィードバック
Powered by Rabbit 2.1.7

Page: 5

報告方法
1. 整理する
✓ 自分の考えが文章になればOK
2. 開発者にとって
リーダブルになるように編集
3. 適切な場所に報告
✓ GitHubのissueとか
フィードバック
Powered by Rabbit 2.1.7

Page: 6

1. 整理する
✓ 自分で自分の気持ちを理解
✓ 自分が読んで理解できる文章に
まとめられれば理解できている
✓ 自分が理解できていないことは
開発者にも伝えられない!
✓ まとめて自分のissueにコメント
メンターへ:メモ(断片)の文書化を手伝って
例:考えを整理できるような質問をする
フィードバック
Powered by Rabbit 2.1.7

Page: 7

2. 編集する
✓ 開発者にとって
リーダブルになるように編集
✓ 「読む人」が理解できることが大事
なのは報告もコードも同じ
✓ まとめて自分のissueにコメント
メンターへ:リーダブル化を手伝って
例:自分が開発者ならこう読めると開発者視点を伝える
メンターへ:他の開発者のことを考える人と一緒に働きたい?
フィードバック
Powered by Rabbit 2.1.7

Page: 8

ヒント:OSS開発の前提
✓ 時間的・空間的に離れている
✓ 朝型・夜型・平日・休日・海外…
✓ 区外・都外・県外・海外…
✓ →直接会わない
✓ でも、情報共有は必要!
✓ →インターネット越しに相談
フィードバック
Powered by Rabbit 2.1.7

Page: 9

OSS開発での相談
✓ 前提
✓ インターネット越し
✓ ポイント
✓ 相手がわかるように書く
✓ 例:省略しない(具体的に書く)
フィードバック
Powered by Rabbit 2.1.7

Page: 10

省略例
インストールしました。
動きませんでした。
どうしたらいいでしょうか?
フィードバック
Powered by Rabbit 2.1.7

Page: 11

省略しない例
次のコマンドでインストール
しました。
% sudo apt-get install ...
(...実行結果...)
↑のように失敗しました。
環境:Ubuntu 15.04 amd64
フィードバック
Powered by Rabbit 2.1.7

Page: 12

なぜ省略しないか
✓ 相手は私を知らない (共通知識が少ない)
✓ →省略すると想像しないといけない
✓ だいたい想像は外れる
✓ →認識違いでおかしなことに…
✓ 相手が理解に必要な時間が減少
✓ リーダブルコードと同じ目標!
フィードバック
Powered by Rabbit 2.1.7

Page: 13

省略しないとは
✓ 詳細を書く
✓ 実行したコマンド・実行結果
✓ やったことを書く
✓ やっていないことを書く
✓ 期待した結果を書く
メンターへ:速くできた人には別のissueでも練習してもらって
メンターへ:全員が少なくとも1つまとめたら報告にいく
フィードバック
Powered by Rabbit 2.1.7

Page: 14

3. 報告する
✓ 適切な場所に報告
✓ 今回はGitHubのissue
✓ OSSによって報告場所は違う
✓ メンターへ
✓ issue登録に二の足を踏んでいる人の
背中を押してあげて
例:自分が開発者ならこの報告をもらったらうれしい、
と開発者視点を伝える
フィードバック
Powered by Rabbit 2.1.7

Other slides

Apache Arrow
2017-06-13
Apache Arrow
2017-05-28
Mroonga!
2015-10-30