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.3k
成長し続ける組織のためのドキュメント
そのまま口伝で続ける?メルカリ、カオナビ、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.3k
知っているようで知らないWebサーバアーキテクチャ
isoparametric
54
20k
Fate/Grand Orderにおける、ディライトワークス流AWS導入&活用術(CEDEC 2016編)
isoparametric
8
2.8k
Fate/Grand Orderにおける、ディライトワークス流 AWS 導入&活用術
isoparametric
29
74k
C++の話(本当にあった怖い話)
isoparametric
1
36
Other Decks in Technology
See All in Technology
現地でMeet Upをやる場合の注意点〜反省点を添えて〜
shotashiratori
0
480
IaC運用を楽にするためにCDK Pipelinesを導入したけど、思い通りにいかなかった話
smt7174
1
100
事業者間調整の行間を読む 調整の具体事例
sugiim
0
490
GitHub Universe: Evaluating RAG apps in GitHub Actions
pamelafox
0
170
初心者に Vue.js を 教えるには
tsukuha
5
380
最速最小からはじめるデータプロダクト / Data Product MVP
amaotone
5
720
MAMを軸とした動画ハンドリングにおけるAI活用前提の整備と次世代ビジョン / abema-ai-mam
cyberagentdevelopers
PRO
1
110
物価高なラスベガスでの過ごし方
zakky
0
320
신뢰할 수 있는 AI 검색 엔진을 만들기 위한 Liner의 여정
huffon
0
170
分布で見る効果検証入門 / ai-distributional-effect
cyberagentdevelopers
PRO
4
690
話題のGraphRAG、その可能性と課題を理解する
hide212131
4
1.4k
よくわからんサービスについての問い合わせが来たときの強い味方 Amazon Q について
kazzpapa3
0
210
Featured
See All Featured
Large-scale JavaScript Application Architecture
addyosmani
510
110k
Practical Orchestrator
shlominoach
186
10k
Fireside Chat
paigeccino
32
3k
The Invisible Side of Design
smashingmag
297
50k
The Art of Delivering Value - GDevCon NA Keynote
reverentgeek
7
150
Code Review Best Practice
trishagee
64
17k
Happy Clients
brianwarren
97
6.7k
Adopting Sorbet at Scale
ufuk
73
9k
The MySQL Ecosystem @ GitHub 2015
samlambert
250
12k
Keith and Marios Guide to Fast Websites
keithpitt
408
22k
We Have a Design System, Now What?
morganepeng
50
7.2k
Testing 201, or: Great Expectations
jmmastey
38
7k
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 ΧδϡΞϧʹ ͯ͠Έ͍ͨ ߹ͪ͜Β ˣ