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
680
ドキュメント改善の仕組みづくり / 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
150
スタイリッシュでモダンな「Gin」管理テーマの紹介 #drupal_haneda
hmaruyama
0
100
DrupalのWeb Profiler #drupal_haneda
hmaruyama
0
210
非エンジニアから開発者まで!DrupalPodを使用したDrupal環境の作成
hmaruyama
1
240
Drupal認定試験にチャレンジしよう!アクイア認定プログラムのご紹介 / introduction of Acquia Drupal Certification Program
hmaruyama
0
700
「Docker/Kubernetes実践コンテナ開発入門」学習のポイント #dockerbg / 20191108
hmaruyama
0
89
enebularでobnizを Lチカ してみた #enebular / 20181122
hmaruyama
0
450
駅すぱあとWebサービス連携ハンズオンパート ノンプログラミングでClovaスキルハンズオン&お茶会 #linebootawards #Clova_CEK / 20180919
hmaruyama
1
490
Agent Friends Xperia Ear Duoで誰でも コミュニケーションにコミット #linebootawards / 20180826
hmaruyama
0
81
Other Decks in Programming
See All in Programming
Elm 0.19.0 Changes
bkuhlmann
0
480
Zero Waste, Radical Magic, and Italian Graft – Quarkus Efficiency Secrets
hollycummins
0
210
Semantic search with Django and pgvector
pauloxnet
0
230
せっかくモデル図描くのなら、嬉しいことが多い方がいいよね!
kuboaki
1
3.1k
"config" ってなんだ? / What is "config"?
okashoi
0
210
From Spring Boot 2 to Spring Boot 3 with Java 22 and Jakarta EE
ivargrimstad
0
880
プールにゆこう
irof
2
120
Ruby Pattern Matching
bkuhlmann
0
920
try!Swift Tokyo 2024 参加報告 LT
akidon0000
1
190
Rubyでたのしむクリエイティブコーディング/Enjoy Creative coding with Ruby
chobishiba
1
160
puregoの活用例
aethiopicuschan
0
220
Designing for tomorrow's programming workflows
honnibal
PRO
2
110
Featured
See All Featured
Code Review Best Practice
trishagee
54
15k
[RailsConf 2023 Opening Keynote] The Magic of Rails
eileencodes
9
8.3k
Scaling GitHub
holman
457
140k
jQuery: Nuts, Bolts and Bling
dougneiner
59
7.1k
It's Worth the Effort
3n
180
27k
Fashionably flexible responsive web design (full day workshop)
malarkey
397
65k
実際に使うSQLの書き方 徹底解説 / pgcon21j-tutorial
soudai
119
38k
The Cult of Friendly URLs
andyhume
74
5.7k
A better future with KSS
kneath
231
16k
How GitHub Uses GitHub to Build GitHub
holman
468
290k
Mobile First: as difficult as doing things right
swwweet
216
8.6k
StorybookのUI Testing Handbookを読んだ
zakiyama
11
4.6k
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