なぜか連載を添削することになった話

Nix meetup #4 登壇資料

Transcript

1. なぜか連載を添削することに なった話 ~ r-aizawa視点 ~
2. アジェンダ • 始めに • なぜ添削をすることになったのか • 何を気にしていたのか • 実際のレビュー方法 • まとめ
3. 始めに
4. 自己紹介 • 名前: r-aizawa • エンジニア歴: 6年目 • GitHub: xantibody • 趣味: 人を転職させること • 最近の活動:暇潰しに起業 • 簡単な仕事募集中
5. 注意 • あまり技術的な話をしません • ちょっと抽象度が高いので興味がない人は適当に作業していてください
6. 連載おめでとう • 今日、Software Design 11月号発売しましたね
7. この人が連載しています • たけてぃ
8. なぜか添削している • いろいろあって今、SDの添削している • なんでだろうね • 連載中だし今が旬なのでその話をする
9. なぜすることになったのか
10. Nix meetup #2にて... よくわかんねぇけど俺たち気があうな！
11. 突然の発言 たけてぃ SDでNixの連載するわー
12. そして... natsukiumとaizawa読んで
13. は？
14. 何を気にしていたのか
15. こんな感じで始まった • Nix使い始めて半年くらい • 別に技術売りするタイプでもない • しゃべりだけそこそこかー
16. 俺の役割はなんなんだ • 技術的な指摘はnatsukiumでいい ◦ 実はこいつはnixpkgsのメンテナー • じゃあ俺はなにをするべきなんだ • 一般向けの意見をいうべきなのだろう、たぶん
17. Nixコミュニティに関わって感じたこと • Nixが好きな人たちはアカデミックすぎる ◦ 悪いことじゃないけど内容がムズすぎる • とはいえ実際に使ってほしい人達ってそうじゃないよね • 技術の説明も重要だけど便利そうって思わせる必要はあるはず
18. そして実はこいつら... 左から本当に頭いい、結構頭いい、本物のバカ
19. 要するに • 俺みたいなバカでも分かるようにする ◦ feynman techniqueってやつ • なんかおもしろそう、便利そうと思わせる • いったん使わせるようにする Richard Feynman wiki
20. ちなみに この感覚はたけてぃも予想して依頼してくれていたみたい
21. 実際のレビュー方法
22. 流れ 1. GitHubに上がったorg管理（重要）された記事を読む 2. 気になったところを指摘する 3. たけてぃが修正するか判断する
23. そして... • たけてぃからの圧 はよ添削しろや
24. 1. 細かい表現の話 • こういう指摘は地味に大事だと思っている • ピンとくるかこないかで読みやすさやツール の期待度は変わる • 適切にNixを評価できるエンジニアは気にな らないと思う
25. 2. 構成がだめだめで書きなおさせた • 記述量が多くてこんな会話をして削除した • 壁打ち役としても使われている • 構成の違和感や順番は一番指摘しているか も ◦ 順番や構成が整えばなんとなく理解できる （ハズ）
26. 3 たとえ話を使いたい • 基本的にNixは概念が難しいと思っている ◦ CSとか専攻してたりするとそうでもないかも • そのためなるべく機能にはたとえ話を添えた かった • イメージできるものがあるだけで変わるはず
27. おまけ • こういうバカな話もしている
28. まとめ
29. まとめ • 人の記事を他人に説明できるように添削しているので理解度UP • フリーター時代いっぱいバイトした経験が活きた ◦ 非エンジニアの感覚が残っていたので意外とためになった ◦ そういう対象を説得するにはちょうどよいレビュアーだったかもしれない • 意外と抽象度の高いレイヤの情報整理は得意かもしれないと思ってきた ◦ 強みを理解できた ◦ 吉岡さん（編集者）に褒められてなるほどとなった
30. ご清聴ありがとうございました
31. そして
32. たけてぃ
33. はやく俺とnatsukiumに焼き肉奢ってね