= フィードバック

: author
   OSS Gate
: content-source
   OSS Gateワークショップ
: date
   2016-09-24
: allotted-time
   15m
: theme
   clear-blue

= 目的の確認

(('tag:center'))
(('tag:x-large'))
OSS開発((*未*))経験者\n
↓\n
OSS開発　経験者

= 現状確認

  * インストールはできた？
  * ドキュメント通り実行できた？
  * (('wait'))((*楽しんだ？*))

= フィードバック

  * メモが溜まっているはず
    * 不備があることを書いたやつ
    * うまくいかないことを書いたやつ
  * upstream（開発元）に報告

= 報告方法

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

= 1. 整理する

  * 自分で自分の気持ちを理解
    * 自分が読んで理解できる文章に\n
      まとめられれば理解できている
    * 自分が理解できていないことは\n
      開発者にも伝えられない！
    * まとめて自分のissueにコメント
    * メンターに確認依頼

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

= 2. 編集する

  * ((*開発者にとって*))\n
    わかりやすくなるように編集
    * 報告方針をまとめているOSSもある\n
      (('note:例：GitHubにあるCONTRIBUTING.md'))
    * まとめて自分のissueにコメント
    * メンターに確認依頼

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

= OSS開発での相談

  * 前提
    * インターネット越し
  * ポイント
    * ((*相手が*))わかるように書く
    * 例：省略しない（具体的に書く）

= 省略例

  # blockquote

  インストールしました。

  動きませんでした。

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

= 省略しない例

  # blockquote

  次のコマンドでインストールしました。

    % sudo apt-get install ...
    （...実行結果...）

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

  環境：Ubuntu 15.04 amd64

= なぜ省略しないか

  * 相手は私を知らない(('note:（共通知識：少）'))
    * →省略すると((*想像*))しないといけない
    * だいたい((*想像は外れる*))
    * →認識違いでおかしなことに…
  * 相手が理解に必要な時間が減少
    * やりとりがスムーズになる

= 省略しないとは

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

= 3. 報告する

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

= デモ