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
810
ドキュメント改善の仕組みづくり / 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
230
DrupalのWeb Profiler #drupal_haneda
hmaruyama
0
330
非エンジニアから開発者まで!DrupalPodを使用したDrupal環境の作成
hmaruyama
1
330
Drupal認定試験にチャレンジしよう!アクイア認定プログラムのご紹介 / introduction of Acquia Drupal Certification Program
hmaruyama
0
980
「Docker/Kubernetes実践コンテナ開発入門」学習のポイント #dockerbg / 20191108
hmaruyama
0
140
enebularでobnizを Lチカ してみた #enebular / 20181122
hmaruyama
0
580
駅すぱあとWebサービス連携ハンズオンパート ノンプログラミングでClovaスキルハンズオン&お茶会 #linebootawards #Clova_CEK / 20180919
hmaruyama
1
630
Agent Friends Xperia Ear Duoで誰でも コミュニケーションにコミット #linebootawards / 20180826
hmaruyama
0
120
Other Decks in Programming
See All in Programming
FindyにおけるTakumi活用と脆弱性管理のこれから
rvirus0817
0
490
実用的なGOCACHEPROG実装をするために / golang.tokyo #40
mazrean
1
250
Introducing ReActionView: A new ActionView-compatible ERB Engine @ Rails World 2025, Amsterdam
marcoroth
0
640
1から理解するWeb Push
dora1998
7
1.8k
go test -json そして testing.T.Attr / Kyoto.go #63
utgwkk
3
280
テストコードはもう書かない:JetBrains AI Assistantに委ねる非同期処理のテスト自動設計・生成
makun
0
250
AIコーディングAgentとの向き合い方
eycjur
0
270
プロパティベーステストによるUIテスト: LLMによるプロパティ定義生成でエッジケースを捉える
tetta_pdnt
0
300
AIと私たちの学習の変化を考える - Claude Codeの学習モードを例に
azukiazusa1
8
3.5k
250830 IaCの選定~AWS SAMのLambdaをECSに乗り換えたときの備忘録~
east_takumi
0
390
MCPで実現するAIエージェント駆動のNext.jsアプリデバッグ手法
nyatinte
7
1.1k
奥深くて厄介な「改行」と仲良くなる20分
oguemon
1
510
Featured
See All Featured
The Web Performance Landscape in 2024 [PerfNow 2024]
tammyeverts
9
810
StorybookのUI Testing Handbookを読んだ
zakiyama
31
6.1k
The Invisible Side of Design
smashingmag
301
51k
4 Signs Your Business is Dying
shpigford
184
22k
"I'm Feeling Lucky" - Building Great Search Experiences for Today's Users (#IAC19)
danielanewman
229
22k
Typedesign – Prime Four
hannesfritz
42
2.8k
The Cost Of JavaScript in 2023
addyosmani
53
8.9k
What's in a price? How to price your products and services
michaelherold
246
12k
Build your cross-platform service in a week with App Engine
jlugia
231
18k
Code Reviewing Like a Champion
maltzj
525
40k
BBQ
matthewcrist
89
9.8k
Thoughts on Productivity
jonyablonski
70
4.8k
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