フィードバック

: author

須藤功平

: institution

株式会社クリアコード

: content-source

OSS Gateワークショップ

: date

2016-03-26

: allotted-time

15m

: theme

clear-blue

目的の確認

((‘tag:center’)) ((‘tag:x-large’)) ビギナーのn OSS開発参加へのn 不安を払拭

現状確認

* インストールはできた?
* ドキュメント通り実行できた?
* (('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開発の前提

* 時間的・空間的に離れている
  * 朝型・夜型・平日・休日・海外…
  * 区外・都外・県外・海外…
  * →直接会わない
* でも、情報共有は必要!
  * →インターネット越しに相談

OSS開発での相談

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

省略例

# blockquote

インストールしました。

動きませんでした。

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

省略しない例

# blockquote

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

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

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

環境:Ubuntu 15.04 amd64

なぜ省略しないか

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

省略しないとは

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

3. 報告する

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