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.6k
成長し続ける組織のためのドキュメント
そのまま口伝で続ける?メルカリ、カオナビ、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.4k
知っているようで知らないWebサーバアーキテクチャ
isoparametric
54
20k
Fate/Grand Orderにおける、ディライトワークス流AWS導入&活用術(CEDEC 2016編)
isoparametric
8
2.9k
Fate/Grand Orderにおける、ディライトワークス流 AWS 導入&活用術
isoparametric
29
74k
C++の話(本当にあった怖い話)
isoparametric
1
57
Other Decks in Technology
See All in Technology
コンテナサプライチェーンセキュリティ
kyohmizu
1
140
エンジニアリング価値を黒字化する バリューベース戦略を用いた 技術戦略策定の道のり
kzkmaeda
6
2.5k
Cracking the Coding Interview 6th Edition
gdplabs
14
28k
Windows の新しい管理者保護モード
murachiakira
0
200
コンピュータビジョンの社会実装について考えていたらゲームを作っていた話
takmin
1
590
データベースの負荷を紐解く/untangle-the-database-load
emiki
2
500
急成長する企業で作った、エンジニアが輝ける制度/ 20250227 Rinto Ikenoue
shift_evolve
0
120
入門 PEAK Threat Hunting @SECCON
odorusatoshi
0
150
(機械学習システムでも) SLO から始める信頼性構築 - ゆる SRE#9 2025/02/21
daigo0927
0
260
OSS構成管理ツールCMDBuildを使ったAWSリソース管理の自動化
satorufunai
0
630
あなたが人生で成功するための5つの普遍的法則 #jawsug #jawsdays2025 / 20250301 HEROZ
yoshidashingo
2
270
OPENLOGI Company Profile for engineer
hr01
1
20k
Featured
See All Featured
Chrome DevTools: State of the Union 2024 - Debugging React & Beyond
addyosmani
4
370
Fight the Zombie Pattern Library - RWD Summit 2016
marcelosomers
233
17k
The Myth of the Modular Monolith - Day 2 Keynote - Rails World 2024
eileencodes
21
2.5k
XXLCSS - How to scale CSS and keep your sanity
sugarenia
248
1.3M
Performance Is Good for Brains [We Love Speed 2024]
tammyeverts
7
640
Principles of Awesome APIs and How to Build Them.
keavy
126
17k
Unsuck your backbone
ammeep
669
57k
Building Adaptive Systems
keathley
40
2.4k
Code Review Best Practice
trishagee
67
18k
Building a Scalable Design System with Sketch
lauravandoore
461
33k
Mobile First: as difficult as doing things right
swwweet
223
9.4k
How GitHub (no longer) Works
holman
314
140k
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 ΧδϡΞϧʹ ͯ͠Έ͍ͨ ߹ͪ͜Β ˣ