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
320
非エンジニアから開発者まで!DrupalPodを使用したDrupal環境の作成
hmaruyama
1
320
Drupal認定試験にチャレンジしよう!アクイア認定プログラムのご紹介 / introduction of Acquia Drupal Certification Program
hmaruyama
0
980
「Docker/Kubernetes実践コンテナ開発入門」学習のポイント #dockerbg / 20191108
hmaruyama
0
130
enebularでobnizを Lチカ してみた #enebular / 20181122
hmaruyama
0
570
駅すぱあとWebサービス連携ハンズオンパート ノンプログラミングでClovaスキルハンズオン&お茶会 #linebootawards #Clova_CEK / 20180919
hmaruyama
1
620
Agent Friends Xperia Ear Duoで誰でも コミュニケーションにコミット #linebootawards / 20180826
hmaruyama
0
110
Other Decks in Programming
See All in Programming
オンコール⼊⾨〜ページャーが鳴る前に、あなたが備えられること〜 / Before The Pager Rings
yktakaha4
2
990
Advanced Micro Frontends: Multi Version/ Framework Scenarios @WAD 2025, Berlin
manfredsteyer
PRO
0
390
SQLアンチパターン第2版 データベースプログラミングで陥りがちな失敗とその対策 / Intro to SQL Antipatterns 2nd
twada
PRO
15
2k
The Modern View Layer Rails Deserves: A Vision For 2025 And Beyond @ RailsConf 2025, Philadelphia, PA
marcoroth
2
730
GPUを計算資源として使おう!
primenumber
1
250
20250704_教育事業におけるアジャイルなデータ基盤構築
hanon52_
5
1.1k
フロントエンドのパフォーマンスチューニング
koukimiura
5
2k
マッチングアプリにおけるフリックUIで苦労したこと
yuheiito
0
190
AI時代の『改訂新版 良いコード/悪いコードで学ぶ設計入門』 / ai-good-code-bad-code
minodriven
24
9.6k
Hack Claude Code with Claude Code
choplin
7
2.6k
なぜ「共通化」を考え、失敗を繰り返すのか
rinchoku
1
680
型で語るカタ
irof
0
700
Featured
See All Featured
Code Reviewing Like a Champion
maltzj
524
40k
A Tale of Four Properties
chriscoyier
160
23k
No one is an island. Learnings from fostering a developers community.
thoeni
21
3.4k
Let's Do A Bunch of Simple Stuff to Make Websites Faster
chriscoyier
507
140k
Keith and Marios Guide to Fast Websites
keithpitt
411
22k
Reflections from 52 weeks, 52 projects
jeffersonlam
351
21k
The Invisible Side of Design
smashingmag
301
51k
Designing Experiences People Love
moore
142
24k
Become a Pro
speakerdeck
PRO
29
5.4k
Java REST API Framework Comparison - PWX 2021
mraible
31
8.7k
Fantastic passwords and where to find them - at NoRuKo
philnash
51
3.3k
Cheating the UX When There Is Nothing More to Optimize - PixelPioneers
stephaniewalter
282
13k
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