Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
ドキュメント改善の仕組みづくり / DevRel Meetup in Tokyo #23
Search
HikaruMaruyama
September 06, 2017
Programming
0
800
ドキュメント改善の仕組みづくり / DevRel Meetup in Tokyo #23
HikaruMaruyama
September 06, 2017
Tweet
Share
More Decks by HikaruMaruyama
See All by HikaruMaruyama
OSS CMS「Drupal 10」 エッセンシャル:最新版でのWeb開発の魅力を探る #oscnagoya
hmaruyama
0
260
スタイリッシュでモダンな「Gin」管理テーマの紹介 #drupal_haneda
hmaruyama
0
210
DrupalのWeb Profiler #drupal_haneda
hmaruyama
0
310
非エンジニアから開発者まで!DrupalPodを使用したDrupal環境の作成
hmaruyama
1
310
Drupal認定試験にチャレンジしよう!アクイア認定プログラムのご紹介 / introduction of Acquia Drupal Certification Program
hmaruyama
0
970
「Docker/Kubernetes実践コンテナ開発入門」学習のポイント #dockerbg / 20191108
hmaruyama
0
130
enebularでobnizを Lチカ してみた #enebular / 20181122
hmaruyama
0
560
駅すぱあとWebサービス連携ハンズオンパート ノンプログラミングでClovaスキルハンズオン&お茶会 #linebootawards #Clova_CEK / 20180919
hmaruyama
1
610
Agent Friends Xperia Ear Duoで誰でも コミュニケーションにコミット #linebootawards / 20180826
hmaruyama
0
110
Other Decks in Programming
See All in Programming
datadog dash 2025 LLM observability for reliability and stability
ivry_presentationmaterials
0
110
CursorはMCPを使った方が良いぞ
taigakono
1
180
Team operations that are not burdened by SRE
kazatohiei
1
210
GoのGenericsによるslice操作との付き合い方
syumai
3
690
Elixir で IoT 開発、 Nerves なら簡単にできる!?
pojiro
1
150
なぜ適用するか、移行して理解するClean Architecture 〜構造を超えて設計を継承する〜 / Why Apply, Migrate and Understand Clean Architecture - Inherit Design Beyond Structure
seike460
PRO
1
690
アンドパッドの Go 勉強会「 gopher 会」とその内容の紹介
andpad
0
260
「ElixirでIoT!!」のこれまでとこれから
takasehideki
0
370
0626 Findy Product Manager LT Night_高田スライド_speaker deck用
mana_takada
0
110
関数型まつりレポート for JuliaTokai #22
antimon2
0
150
設計やレビューに悩んでいるPHPerに贈る、クリーンなオブジェクト設計の指針たち
panda_program
6
1.4k
What Spring Developers Should Know About Jakarta EE
ivargrimstad
0
250
Featured
See All Featured
Why Our Code Smells
bkeepers
PRO
337
57k
Rails Girls Zürich Keynote
gr2m
94
14k
CSS Pre-Processors: Stylus, Less & Sass
bermonpainter
357
30k
Being A Developer After 40
akosma
90
590k
Improving Core Web Vitals using Speculation Rules API
sergeychernyshev
17
940
Stop Working from a Prison Cell
hatefulcrawdad
270
20k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
smashingmag
252
21k
The Art of Delivering Value - GDevCon NA Keynote
reverentgeek
15
1.5k
Producing Creativity
orderedlist
PRO
346
40k
Learning to Love Humans: Emotional Interface Design
aarron
273
40k
Connecting the Dots Between Site Speed, User Experience & Your Business [WebExpo 2025]
tammyeverts
5
210
Building Flexible Design Systems
yeseniaperezcruz
328
39k
Transcript
2017/9/5 DevRel Meetup in Tokyo #23 גࣜձࣾϰΝϧݚڀॴ ؙࢁͻ͔Δ υΩϡϝϯτվળͷ Έͮ͘Γ
Profile ؙࢁͻ͔Δ גࣜձࣾϰΝϧݚڀॴ ςΫχΧϧΤόϯδΣϦετ ਆಸݝ૬ݪࢢࡏॅ IJLBSVNBSVZBNB !NBSVZBNBIJBLSV IUUQIJJJJJJJIJLBSVIBUFOBEJBSZDPN
1988 ࠃॳͷҊιϑτ Ӻ͢ͺ͋ͱ ͕ੜ͠·ͨ͠ɻ ݸਓར༻͚ͩͰͳ͘ɺ ϏδωεγʔϯͰଟ͘ͷ ࠾༻࣮͕͋Γ·͢ɻ Έͳ͞Μ͝ଘ Yahoo࿏ઢਤ
Ӻ͢ͺ͋ͱͷΤϯδϯͰ͢ɻ “Ҋ”ͷձࣾͰ͢
“Ӻ͢ͺ͋ͱ”ͷWebAPI Ӻ͢ͺ͋ͱWebαʔϏε
Ӻ͢ͺ͋ͱwebαʔϏεͰɺ APIͷ༷αϯϓϧίʔυ͕ஔ͍ͯ͋Δ υΩϡϝϯταΠτ (http://docs.ekispert.com/v1/) Λެ։͍ͯ͠·͢ɻ 2015͔ΒݱࡏʹࢸΔ·Ͱɺ ϢʔβʹΑΓศརʹͬͯΒ͑ΔΑ͏ʹ νʔϜΛ݁ͯ͠վળ׆ಈΛߦ͍ͬͯ·͢ɻ
ࠓͷຊɿ ࠓͰܧଓతʹυΩϡϝϯτվળ͕ ߦ͍͑ͯΔ͠ɺ ͳ͔ͳ͔͍͍ײ͡ʹճͬͯΔײ͕͢͡ΔͷͰ ͏ͪͰऔΓΜͰ͍Δ վળͷΈʹ͍͓ͭͯ͠·͢ɻ
·ͣɿ վળͯ͠Կ͕Ͳ͏ྑ͘ͳͬͨͷ͔ʁ
Before ݹष͍σβΠϯͩʜ "1*ͷ༷͔͠ ࡌ͍ͬͯͳ͍ʜ
After Ϩεϙϯγϒ σβΠϯͩʂ "1*ͷ༷͚ͩͰͳ͘ 5JQT'"2ͳͲ ίϯςϯπ૿͑ͯΔʂ
ྑ͘ͳͬͨͦͷ1. ίϯςϯπΛ֦ॆͯ͠Ϣʔβͷʹͨͯͨ • Ϣʔβ͔ΒΑ͓͍͘߹ΘͤΛ͍͍ͯͨ༰Λ TipsFAQͳͲͷ߲Ͱٵऩ • υΩϡϝϯτ͕Θ͔Γ͍͢͜ͱͰɺ Ϣʔβͷ։ൃίετ͕ܰݮ • υΩϡϝϯτ͕ܾΊखͰ
Ӻ͢ͺ͋ͱwebαʔϏεΛબΜͰ͘Εͨέʔε • ಋೖࣄྫͰ υΩϡϝϯτ͕๙ΊΒΕΔΑ͏ʹͳͬͨ
ྑ͘ͳͬͨͦͷ2. υΩϡϝϯτʹใΛू͢Δ͜ͱͰ ۀָ͕ʹͳͬͨ Ӧۀଆ • ʮఆظ߇আͷखॱʯʹ͍ͭͯϢʔβ͔Β͍߹ΘͤΛड͚ͨࡍʹɺ ࠓ·ͰͩͬͨΒAPIͷϦΫΤετύϥϝʔλྫͳͲΛهड़ͯ͠ આ໌Λߦ͍ͬͯͨͷͰɺखؒͱ͕͔͔͍࣌ؒͬͯͨ • ࠓɺʮఆظ݊ར༻࣌ͷӡܭࢉʯϖʔδͷURLΛҊ͢Δ͚ͩͰɺ
త͔֬ͭਝͳฦ৴͕Ͱ͖ΔΑ͏ʹͳͬͨ ։ൃଆ • Ӧۀ/αϙʔτ͔ΒΤεΧϨʔγϣϯ͢Δαϙʔτۀ͕ɺ վળલͱվળޙͰ20%ݮ • υΩϡϝϯτʹίϯςϯπΛ֦ॆ͔ͯ͠Βɺ ಉ͡Α͏ͳ༰ͷ͍߹Θͤগͳ͘ͳͬͨ
υΩϡϝϯτͷվળ׆ಈ Ռ͕ग़ͨΈ͍ͨͩ
υΩϡϝϯτվળ ͳͥ͏·͍ͬͨ͘ͷ͔ ࠓ·Ͱ͖ͬͯͨ͜ͱΛৼΓฦͬͯΈͨ
খ͍͞νʔϜΛ ࡞Δ ؔऀΛ ἧ͑Δ ఆྫձٞΛ ઃ͚Δ ܧଓతʹ ϦϦʔε͢Δ
খ͍͞νʔϜΛ ࡞Δ ؔऀΛ ἧ͑Δ ఆྫձٞΛ ઃ͚Δ ܧଓతʹ ϦϦʔε͢Δ
খ͍͞νʔϜΛ࡞Δ খ͍͞νʔϜͷϝϦοτ • ૉૣ͍ใڞ༗ͱҙࢥܾఆ • ॊೈͳํస • ίϛϡχέʔγϣϯָ͕ Ӻ͢ͺ͋ͱwebαʔϏε ͷ߹
ܭ3໊ͷʮυΩϡϝϯτվળνʔϜʯΛ݁͠ɺ ͦͷνʔϜͷϝϯόʔ͕த৺ͱͳΓυΩϡϝϯτͷվળΛߦͬͨ
খ͍͞νʔϜΛ ࡞Δ ؔऀΛ ἧ͑Δ ఆྫձٞΛ ઃ͚Δ ܧଓతʹ ϦϦʔε͢Δ
ؔऀΛἧ͑Δ ग़ΓΛ͙ ։ൃ෦ॺͷਓ͚ؒͩ/Ӧۀ෦ॺͷਓ͚ؒͩ ͷɺ ภͬͨϝϯόʔฤग़ΓΛੜΉ ӦۀʮϢʔβʹͦΜͳઆ໌ͷํ͍ͯ͠ͳ͍ʯ ։ൃʮυΩϡϝϯτʹهࡌ͞Ε͍ͯΔ༷͕ؒҧ͍ͬͯΔʯ Ӻ͢ͺ͋ͱWebαʔϏε ͷ߹ ϢʔβͷΛฉ͘ਓ(Ӧۀɺαϙʔτ෦ॺ)ͱɺ
υΩϡϝϯταΠτʹө͢Δਓ(։ൃ෦ॺ)ΛϝϯόʔʹೖΕͨ
খ͍͞νʔϜΛ ࡞Δ ؔऀΛ ἧ͑Δ ఆྫձٞΛ ઃ͚Δ ܧଓతʹ ϦϦʔε͢Δ
ఆྫձٞΛઃ͚Δ վળ͠ଓ͚Δ վળࣗͨͪΛָʹ͢Δ͜ͱ͕Ͱ͖Δ վળΛࢭΊͯ͠·͏ͱ…? վળΛ࣋ଓ͢ΔͨΊʹɺཱͪࢭ·ΔػձΛڧ੍తʹઃ͚Δ Ӻ͢ͺ͋ͱWebαʔϏε ͷ߹ ݄1ճͷఆྫϛʔςΟϯάΛ։࠵
খ͍͞νʔϜΛ ࡞Δ ؔऀΛ ἧ͑Δ ఆྫձٞΛ ઃ͚Δ ܧଓతʹ ϦϦʔε͢Δ
ܧଓతʹϦϦʔε͢Δ ϞνϕʔγϣϯΛ࣋ଓͤ͞Δ Ϟνϕʔγϣϯ্͕͕Βͳ͍վળɺ ్தͰΊͨ͘ͳΔ ͦ͏ͳΒͳ͍ͨΊʹɺখ͞ͳޭମݧΛੵΈॏͶͯɺ ϞνϕʔγϣϯΛ࣋ଓͤ͞Δ Ӻ͢ͺ͋ͱWebαʔϏε ͷ߹ λεΫΛղͯ͠খ͘͞ϦϦʔεɺͦΕΛͪΐͪ͜ΐ͜ͱ খ͘͞ϦϦʔε͢Δ͜ͱ͕ۤʹͳΒͳ͍Α͏ʹσϓϩΠڥΛඋ
খ͍͞νʔϜΛ ࡞Δ ؔऀΛ ἧ͑Δ ఆྫձٞΛ ઃ͚Δ ܧଓతʹ ϦϦʔε͢Δ
ؔऀΛूΊͨখ͞ͳνʔϜΛ࡞Δ͜ͱͰɺ ग़ΓίϛϡχέʔγϣϯίετΛ ۃྗഉআ͠ɺ ޮతʹվળΛਐΊΔ͜ͱ͕Ͱ͖ͨ Good!
ͨͩ͠ɺগਓ੍ ଐਓԽΛੜΉՄೳੑ͋Γ গͣͭ͠ੈަΛ͢Δͷ͕݈શ͔ Bad…
ੈަΛਤΔͨΊɺ Ӻ͢ͺ͋ͱwebαʔϏεͷ։ൃ෦ॺʹ ଐ͞Εͨ৽ਓΛೖͯ͠Έ͍ͯΔɻ ྑ͍νʔϜͷঢ়ଶΛ่ͣ͞ʹɺ ਓΛগͣͭ͠ϩʔςʔγϣϯ͍ͯ͘͠ͷ͕ཧɻ Hmm.
Thank you