Slide 1
Slide 1 text
APIリファレンスを
読み込むと楽しい
yuhi
2026/2/6@きたく.dev
Slide 2
Slide 2 text
自己紹介
yuhi
株式会社プレックス
● バックエンド / Rails書いてます
● 北区でもないし、帰宅導線でもない
市川市妙典在住
● 東葛.dev 出⾝
● BuriKaigi2026
のご縁でやってきました🙌
Slide 3
Slide 3 text
皆さんの帰宅のお供は何でしょう？
Slide 4
Slide 4 text
もちろんAPIリファレンスですよね
Slide 5
Slide 5 text
APIリファレンスとは？
Slide 6
Slide 6 text
ソフトウェアが公開している
API仕様書と定義します
Slide 7
Slide 7 text
こんなのとか（ Rails, MDN, Go）
Slide 8
Slide 8 text
読んだことあるよって方 🙋
Slide 9
Slide 9 text
APIリファレンスを読み込んでおり
その取り組みを紹介したい
Slide 10
Slide 10 text
まずは自分の興味が沸く
ソフトウェア / OSSを見つけよう
Slide 11
Slide 11 text
自分の場合は Ruby on Rails
Slide 12
Slide 12 text
2パターンの読み込み方
Slide 13
Slide 13 text
基本編 と 深掘り編
Slide 14
Slide 14 text
基本編
Slide 15
Slide 15 text
基本編
● APIリファレンスを読む
● 所感をメモる
Slide 16
Slide 16 text
具体例
Slide 17
Slide 17 text
APIリファレンスを読んで
Slide 18
Slide 18 text
所感をメモる
Slide 19
Slide 19 text
基本編のメリット・デメリット
● メリット
○ APIあたりにかかる時間が短い
○ 網羅的にインデックスを貼ることができる
● デメリット
○ 退屈になりやすい
Slide 20
Slide 20 text
深掘り編
Slide 21
Slide 21 text
深掘り編
1. 実装・テストを読む
2. git blameを見る
3. コントリビュートする
Slide 22
Slide 22 text
1. 実装・テストを読む
Slide 23
Slide 23 text
裏側の仕組みを知れて
知的好奇心を満たせる
Slide 24
Slide 24 text
設計や実装の学びも多い
Slide 25
Slide 25 text
テストを読むと実装者の意図がわかって
よりAPIの解像度が上がる
Slide 26
Slide 26 text
2. git blameを読む
Slide 27
Slide 27 text
そのAPIの背景が見えてくる
Slide 28
Slide 28 text
普段意識しないような
パフォーマンスの観点で修正が加えられたり
Slide 29
Slide 29 text
優秀なエンジニア達のディスカッションを覗ける
Slide 30
Slide 30 text
3. コントリビュートする
Slide 31
Slide 31 text
実装やblameまで読むと
Slide 32
Slide 32 text
APIリファレンスに
コントリビュートする材料が揃う
Slide 33
Slide 33 text
typoやマークアップ漏れや
Slide 34
Slide 34 text
APIの変更後にリファレンスが適切に
更新されていなかったり
Slide 35
Slide 35 text
内部APIが誤ってリファレンスに
露出されてしまっていたり
Slide 36
Slide 36 text
何か違和感を感じたらコントリビュートしよ
う
Slide 37
Slide 37 text
コントリビュータ、メンテナー
利用者 の三方よしな取り組み
Slide 38
Slide 38 text
基本的に喜ばれます！！！
Slide 39
Slide 39 text
深掘り編のメリット・デメリット
● メリット
○ 普段知れない知識に出会えることも多い
○ コントリビュートチャンスも増える
● デメリット
○ めちゃくちゃ時間がかかる
Slide 40
Slide 40 text
そもそも始めたきっかけは
Slide 41
Slide 41 text
学習のためというのもあるが
Slide 42
Slide 42 text
カンファレンス登壇がしたい
Slide 43
Slide 43 text
全部読んでみた系 や
コントリビュートでネタを作るのが野望
Slide 44
Slide 44 text
これからの AI時代
人間が開発のボトルネックになると
言われています
Slide 45
Slide 45 text
APIリファレンスを読んで読解の体力をつ
けましょう 💪
Slide 46
Slide 46 text
帰宅のお供に
リファレンス、どうでしょう？