フィードバック

: author

OSS Gate

: content-source

OSS Gateワークショップ

: allotted-time

15m

: theme

clear-blue

現状確認

(1) ユーザーとして動かす
(2) ふりかえり
(3) フィードバックポイントを\n
    発見!
(4) (('wait'))↑を((*フィードバック*))

フィードバック

* upstream(開発元)に\n
  うまくいかなかったことを報告
  * ここで詰まった、を伝える
  * こうだったらよかった、を伝える

報告方法

(1) 整理する
    * 自分の考えが文章になればOK
(2) (('wait'))((*開発者にとって*))\n
    わかりやすくなるように編集
(3) (('wait'))適切な場所に報告
    * GitHubのissueとか

1. 整理する

* 自分で自分の気持ちを理解
  * 自分が読んで理解できる文章に\n
    まとめられれば理解できている
  * 自分が理解できていないことは\n
    開発者にも伝えられない!
  * 作業メモに追記→サポーター確認

(('note:サポーターへ:メモ(断片)の文書化を手伝って'))n (('note:例:考えを整理できるような質問をする'))

整理方法

(('tag:center')) (('tag:x-large')) デモ

* 作業メモを開く
* フィードバック対象を決める
* 自分の気持ちを作業メモに追記
* サポーターに確認依頼

2. 編集する

* ((*開発者にとって*))\n
  わかりやすくなるように編集
  * 報告方針をまとめているOSSもある\n
    (('note:例:GitHubにあるCONTRIBUTING.md'))
  * 作業メモに追記→サポーターに確認

(('note:サポーターへ:リーダブル化を手伝って'))n (('note:例:自分が開発者ならこう読めると開発者視点を伝える'))n

編集の仕方

* ポイント
  * ((*相手が*))わかるように書く
  * 例:省略しない(具体的に書く)

省略例

# blockquote

インストールしました。

動きませんでした。

どうしたらいいでしょうか?

省略しない例

# blockquote

↓でインストール

  % sudo apt-get install ...
  (...実行結果...)

↑のように失敗しました。

環境:Ubuntu 16.10 amd64

なぜ省略しないか

* 相手は私を知らないから
  * 省略すると((*想像*))しないといけない
  * だいたい((*想像は外れる*))
  * 話が噛み合わない!

省略しないとは

* 詳細を書く
  * 実行したコマンド・実行結果
* やったことを書く
* ((*やっていないこと*))を書く
* 期待した結果を書く

編集方法

(('tag:center')) (('tag:x-large')) デモ

* 作業メモを開く
* 自分の気持ちを開発者に伝わるようにまとめて作業メモに追記
* サポーターに確認依頼

3. 報告する

* 適切な場所に報告
  * OSSによって報告場所は違う
* サポーターへ
  * 報告に二の足を踏んでいる人の背中を押してあげて\n
    (('note:例:自分が開発者ならこの報告をもらったらうれしい、と開発者視点を伝える'))

報告方法

(('tag:center')) (('tag:x-large')) デモ

* 報告方法を探す
* サポーターに後押ししてもらう
* まとめた報告内容を報告

ふりかえり2:デモ

(('tag:center')) (('tag:x-large')) デモ

* ビギナー:
  * 作業メモを元に説明
* サポーター:
  * よいところをよいと言う!
  * フィードバックポイントを確認
  * 完了→issueにコメント

ふりかえり2:進め方

* ビギナー1人ずつ順番に
* 対象ビギナーの作業ログを\n
  ディスプレイに映す
* 同じ島のみんなで↑を見ながら