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
成長し続ける組織のためのドキュメント
Search
Yuki Tamura
March 05, 2024
Technology
8
2.8k
成長し続ける組織のためのドキュメント
そのまま口伝で続ける?メルカリ、カオナビ、estieの試行錯誤から学ぶ設計ドキュメントの活用方法
https://offers.connpass.com/event/310086/
の登壇資料です。
Yuki Tamura
March 05, 2024
Tweet
Share
More Decks by Yuki Tamura
See All by Yuki Tamura
優れたエンジニアが集まり継続的に成長する会社にする方法 ~組織を急拡大させる採用育成評価ガイド~/Concise Guide to Finding the Best Technical Talent
isoparametric
92
72k
なぜ技術がないと 面白いゲームが創れないのか?
isoparametric
9
7.5k
知っているようで知らないWebサーバアーキテクチャ
isoparametric
54
21k
Fate/Grand Orderにおける、ディライトワークス流AWS導入&活用術(CEDEC 2016編)
isoparametric
8
2.9k
Fate/Grand Orderにおける、ディライトワークス流 AWS 導入&活用術
isoparametric
29
75k
C++の話(本当にあった怖い話)
isoparametric
1
85
Other Decks in Technology
See All in Technology
組織全員で向き合うAI Readyなデータ利活用
gappy50
0
280
「最速」で Gemini CLI を使いこなそう! 〜Cloud Shell/Cloud Run の活用〜 / The Fastest Way to Master the Gemini CLI — with Cloud Shell and Cloud Run
aoto
PRO
1
180
AIエージェントによる業務効率化への飽くなき挑戦-AWS上の実開発事例から学んだ効果、現実そしてギャップ-
nasuvitz
5
1.2k
Kubernetes self-healing of your workload
hwchiu
0
520
だいたい分かった気になる 『SREの知識地図』 / introduction-to-sre-knowledge-map-book
katsuhisa91
PRO
3
1.4k
ソースを読む時の思考プロセスの例-MkDocs
sat
PRO
1
170
From Natural Language to K8s Operations: The MCP Architecture and Practice of kubectl-ai
appleboy
0
210
オブザーバビリティと育てた ID管理・認証認可基盤の歩み / The Journey of an ID Management, Authentication, and Authorization Platform Nurtured with Observability
kaminashi
1
680
[VPoE Global Summit] サービスレベル目標による信頼性への投資最適化
satos
0
250
ソフトウェアエンジニアの生成AI活用と、これから
lycorptech_jp
PRO
0
900
Implementing and Evaluating a High-Level Language with WasmGC and the Wasm Component Model: Scala’s Case
tanishiking
0
180
初めてのDatabricks Apps開発
taka_aki
1
400
Featured
See All Featured
A designer walks into a library…
pauljervisheath
209
24k
Statistics for Hackers
jakevdp
799
220k
The Cult of Friendly URLs
andyhume
79
6.6k
BBQ
matthewcrist
89
9.9k
GraphQLの誤解/rethinking-graphql
sonatard
73
11k
4 Signs Your Business is Dying
shpigford
185
22k
Mobile First: as difficult as doing things right
swwweet
225
10k
Let's Do A Bunch of Simple Stuff to Make Websites Faster
chriscoyier
508
140k
Side Projects
sachag
455
43k
Practical Tips for Bootstrapping Information Extraction Pipelines
honnibal
PRO
23
1.5k
Scaling GitHub
holman
463
140k
YesSQL, Process and Tooling at Scale
rocio
173
15k
Transcript
:VLJ5BNVSB FTUJF JOD ͠ଓ͚Δ৫ͷͨΊͷ υΩϡϝϯτ ৫ͱϓϩμΫτͷͨΊʹඞཁͳυΩϡϝϯτͱʁ
ຊͷΞδΣϯμ FTUJFͰɺ ͳͥυΩϡϝϯτΛॻ͘ͷ͔ʁ ྑ͍υΩϡϝϯτͷॻ͖ํͱʁ ओͳυΩϡϝϯτͷ͍͚ ࠷ޙʹ
ͳͥFTUJF υΩϡϝϯτΛॻ͘ͷ͔ʁ
Ͳ͏ͯ͜͠͏ͳͬͨʁ ͛͢ʔΫʔϧͳػೳߟ͑ͨΘ དྷिʹϦϦʔεͰ͖ΔͩΖ ͦͷػೳ͕ Ͳ͜ʹԿͷӨڹΛ ༩͑Δͷ͔ ·ΔͰΘ͔ΒΜ ·ͣιʔεΛಡΜͰɺ ͦͷ༷͕༩͑ΔӨڹΛௐͯΈΔ ͱΓ͋͑ͣௐࠪظؒΛϲ݄͘Ε
ແཧͶ ͋Δ
͍͔ͭΒ͜͏ͳͬͨʁ ͜ͷػೳΘΕͯͳ͍͔Β আ͍ͨ͠Μ͕ͩʜʜ ԿͷͨΊʹ͋ΔΜͩʁ ͦͦ͜ͷػೳ ୭͕Ͳ͏͍͏తͰ ͍ΕͨΜ͍ͩʁ ͦΕڈࣙΊͨ1E.͕ Ͳ͏ͯ͠Γ͍͍ͨͬͯ͏͔Β ͕ͬͨͭͩԶৄ͘͠ΒΜ
͊͞ʁ ผͷ
࠷ॳരͰ։ൃ͍ͯͨ͠ػೳ͕ ͍ͭͷ·ʹ͔ᐫͱͳΔ
࣌ͷه͑͋͞Ε ͜Μͳ͜ͱʹͳΒͳ͔ͬͨͷʹ
υΩϡϝϯτաখධՁ͞Ε͍ͯΔ ͍ൣғʹ͍࣌ؒ࣠Ͱ ྑ͍ӨڹΛ༩͑ΒΕΔ།ҰͷखஈͰ͋Δ
ࢥߟɺܾఆɺτϨʔυΦϑΛࣦΘͳ͍ͨΊʹ υΩϡϝϯτΛॻ͔ͳ͚ΕͳΒͳ͍ ͨͩ͠ɺଟ͘ͷਓʹʮಡΜͰΒ͏ʯͨΊʹ ্ख͘ॻ͘ඞཁ͕͋Δ
Ϡ π Β ϥ ϝ ϯ Λ ৯
ͯ Δ Μ ͡ ͳ ͍ ใ Λ ৯ ͯ Δ Μ ͩ ʂ
ྑ͍FTUJF υΩϡϝϯτͷ ॻ͖ํͱʁ
d࣌ؒͰ ํੑΛ໌֬ʹͨ͠ ߘΛॻ͘ εςʔΫϗϧμʔʹ֬ೝ Θ͔Γ͘͢ ಡΈ͘͢ฤू͢Δ ϑΟʔυόοΫΛٻΊ ίϝϯτΛΒ͍ ࣭ΛߴΊΔ
จষฤू࣌ͷϙΠϯτ
ಡΈखͷؾ࣋ͪʹͳΓΘ͔Γ͢͞Λࢦ͢
ෆඞཁͰअຐͳཁૉۃྗऔΓআ͘
Օॻ͖Λ࠷ݶʹ݁͠ʹϑΥʔΧε͢Δ
ࣗͷ࣌ؒΑΓಡΈखͷ࣌ؒΛେʹ͢Δ
దͳ ϑΟʔυόοΫΛಘΔͨΊʹ
۩ମతͳϑΟʔυόοΫΛٻΊΔ͜ͱ ྫ͑ʮࢲ"ͩͱࢥ͍·͕͢ɺ #ͱ͍͏؍͋Γ·͔͢ʁʯ
FTUJFྲྀ υΩϡϝϯτͷ͍͚
FTUJFͰӡ༻͞Ε͍ͯΔओͳυΩϡϝϯτ w%FTJHO%PDT w"%3 "SDIJUFDUVSF%FDJTJPO3FDPSET w13% 1SPEVDU3FRVJSFNFOUT%PDVNFOU
جຊతʹ 3FRVFTUGPS$PNNFOU 3'$ ʢίϝϯτΛٻΊΔʣ
͍ͭԿΛॻ͖͔͘ʁ ͍ͭԿ͕ඞཁͳͷ͔ ·͔ͬͨ͘Βͳ͍ΜͩΑͳ͊
%FTJHO%PDT
%FTJHO%PDTͷత Կ͔Λ࢝ΊΔલʹϑΟʔυόοΫΛٻΊΔ ίϯςΩετɺΞϓϩʔνɺτϨʔυΦϑͳͲهࡌ͢Δ తॏཁͳ'#ΛಘΔ͜ͱͰɺ࣌ؒΛॖ͢ΔͨΊͷͷ
%FTJHO%PDTͷӡ༻ ཷ·Γ͗͢ͳ͍Α͏ʹϝϯςφ͕ϝϯςʢϓογϡʣ͢Δ ํੑ͕ܾ·ͬͨΒదͳॴʹҠಈ͢Δ ܗࣜࣗ༝ͰίϝϯτͰ͖Δঢ়ଶͰ͋ΕͦΕͰྑ͍
͜ͷ%FTJHO%PD ॻ͔Εͨͷ͕ʜʜ ΰϛআ͠ͳ͖Όʜʜ
"%3 "SDIJUFDUVSF%FDJTJPO3FDPSET
"SDIJUFDUVSF%FDJTJPO3FDPSET ઃܭͷج४அΛ໌֬ʹ͓ͯͨ͘͠Ίͷͷ ߋ৽͞ΕΔͷͰͳ͘ɺ͋͘·ͰʮهʯͰ͋Δ ʮબͳ͔ͬͨબࢶʯʮԿނʯ͔Λ͢Α͏ʹ͢Δ
λΠτϧ ݁ ܾఆ εςʔλε ίϯςΩετ ؆ܿʹ ࠓͲ͏͍͏ঢ়گʁ ܾఆมߋͷಈػʁ 1SPTˍ$POTԿʁ ԿΛఏҊɺ࣮ߦ͢Δʁ
͋ͷͱ͖ ͳΜͰͬͪ͜બΜ͚ͩͬ ͔ͬ͢ΓΕͪΌͬͨΑ ͏Ͳ͏ͬͯ ҙࢥܾఆͨ͠ͷ͔ Ա͑ͯͳ͍ʜʜ
13% 1SPEVDU3FRVJSFNFOUT%PDVNFOU
1SPEVDU3FRVJSFNFOUT%PDVNFOU ຊདྷʮ༷ॻʯ͕ͩʮاըॻʯͷҙຯͰΘΕ͖ͯͨ ݱࡏͷͷ༷Λදͨ͢Ίߋ৽͠ͳ͚ΕͳΒͳ͍ ݱࡏɺࢼߦࡨޡதʜʜʂ
1SPCMFN ԿͷΛ ղܾ͢Δʁ 4VDDFTT ղܾ͔ͨ͠ Ͳ͏͔Δʁ 8IBU తʹݴ͏ͱ ͦΕԿʁ 8IFO
͍ͭϦϦʔεʁ ϚΠϧετϯʁ %FTDSJQUJPO ͭ·Γ Ͳ͏͍͏͜ͱʁ 8IZ ͳͥ ղܾ͕ඞཁʁ 8IP ͦΕ ୭ͷͨΊͷʁ )PX ͲͷΑ͏ʹ ࣮ߦ͢Δʁ
ࢤ͔ʁ ಡΈ͍͔͢ʁ ํੑ͕ղΔ͔ʁ ࣌ؒ࣠ݱ࣮త͔ʁ ޭج४͕໌͔֬ʁ
͜ΜͳΫι͍Α͘Θ͔ΒΜจॻ ࠓಡΈͨ͘ͳ͍ͳʜʜ͋ͱʹ͠Α ʢҎԼɺΤϯυϨεʣ
͍ͭॻ͘ʁ ԿͷͨΊʁ ߋ৽͢Δʁ %FTJHO%PDT Կ͔ΛఏҊ͢Δͱ͖ ࢝·Δલ ϑΟʔυόοΫ͔Β ؾ͖ͮΛಘΔ͜ͱͰ ΑΓ࣌ؒΛॖ͢Δ ίϝϯτΛड͚ऴΘͬͨΒ
͏͠ͳ͍ "SDIJUFDUVSF %FDJTJPO 3FDPSET ઃܭʹରͯ͠ ԿΒ͔ͷมߋܾఆ͕ ൃੜ͢Δͱ͖ ʮͳͥʯͦͷܾఆ͕͞Ε͔ͨ ʮͳͥʯଞͷબࢶ બ͞Εͳ͔͔ͬͨه͢Δ ҙࢥܾఆ͕͞ΕͨΒ͠ͳ͍ 1SPEVDU 3FRVJSFNFOU %PDVNFOU ʹ ৽͍༷͕͠Ճ͞ΕΔ߹ ͷ༷Λ໌֬ʹ͠ ϓϩμΫτͷ࣭Λҡ࣋͠ ސ٬ՁΛੜΈग़͢ͷ جຊతʹ͢Δ
࠷ޙʹ
υΩϡϝϯτѪ ʢ1E.ஊʣ
͝ਗ਼ௌ͋Γ͕ͱ͏͍͟͝·ͨ͠ ը૾TPVSDF4IVUUFSTUPDL ΧδϡΞϧʹ ͯ͠Έ͍ͨ ߹ͪ͜Β ˣ