= フィードバック : author OSS Gate : content-source OSS Gateワークショップ : allotted-time 15m : theme clear-blue = 目的の確認 (('tag:center')) (('tag: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:例:自分が開発者ならこの報告をもらったらうれしい、と開発者視点を伝える')) = 報告方法 (('tag:center')) (('tag:x-large')) デモ = ふりかえり:目的 * メンター視点での考え方を知る = ふりかえり:やり方 * 作業メモissueに書いてある! * メンターはコメントしてclose * 後で誰とやったかわかる! = ふりかえり (('tag:center')) (('tag:x-large')) デモ