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
990
「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
Tool Catalog Agent for Bedrock AgentCore Gateway
licux
7
2.5k
Cache Me If You Can
ryunen344
2
4k
「待たせ上手」なスケルトンスクリーン、 そのUXの裏側
teamlab
PRO
0
570
テストカバレッジ100%を10年続けて得られた学びと品質
mottyzzz
2
610
How Android Uses Data Structures Behind The Scenes
l2hyunwoo
0
480
テストコードはもう書かない:JetBrains AI Assistantに委ねる非同期処理のテスト自動設計・生成
makun
0
540
実用的なGOCACHEPROG実装をするために / golang.tokyo #40
mazrean
1
290
Putting The Genie in the Bottle - A Crash Course on running LLMs on Android
iurysza
0
140
アプリの "かわいい" を支えるアニメーションツールRiveについて
uetyo
0
280
Ruby×iOSアプリ開発 ~共に歩んだエコシステムの物語~
temoki
0
350
概念モデル→論理モデルで気をつけていること
sunnyone
3
300
ぬるぬる動かせ! Riveでアニメーション実装🐾
kno3a87
1
230
Featured
See All Featured
YesSQL, Process and Tooling at Scale
rocio
173
14k
CSS Pre-Processors: Stylus, Less & Sass
bermonpainter
358
30k
Automating Front-end Workflow
addyosmani
1370
200k
Building a Modern Day E-commerce SEO Strategy
aleyda
43
7.6k
Speed Design
sergeychernyshev
32
1.1k
Java REST API Framework Comparison - PWX 2021
mraible
33
8.8k
We Have a Design System, Now What?
morganepeng
53
7.8k
Build your cross-platform service in a week with App Engine
jlugia
231
18k
Designing Experiences People Love
moore
142
24k
Chrome DevTools: State of the Union 2024 - Debugging React & Beyond
addyosmani
7
850
Imperfection Machines: The Place of Print at Facebook
scottboms
268
13k
Practical Orchestrator
shlominoach
190
11k
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