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
52
Other Decks in Technology
See All in Technology
白金鉱業Meetup Vol.17_あるデータサイエンティストのデータマネジメントとの向き合い方
brainpadpr
6
760
SA Night #2 FinatextのSA思想/SA Night #2 Finatext session
satoshiimai
1
140
トラシューアニマルになろう ~開発者だからこそできる、安定したサービス作りの秘訣~
jacopen
2
2k
人はなぜISUCONに夢中になるのか
kakehashi
PRO
6
1.7k
The Future of SEO: The Impact of AI on Search
badams
0
200
2.5Dモデルのすべて
yu4u
2
870
(機械学習システムでも) SLO から始める信頼性構築 - ゆる SRE#9 2025/02/21
daigo0927
0
120
Developers Summit 2025 浅野卓也(13-B-7 LegalOn Technologies)
legalontechnologies
PRO
0
720
エンジニアのためのドキュメント力基礎講座〜構造化思考から始めよう〜(2025/02/15jbug広島#15発表資料)
yasuoyasuo
17
6.8k
Data-centric AI入門第6章:Data-centric AIの実践例
x_ttyszk
1
410
「海外登壇」という 選択肢を与えるために 〜Gophers EX
logica0419
0
710
リーダブルテストコード 〜メンテナンスしやすい テストコードを作成する方法を考える〜 #DevSumi #DevSumiB / Readable test code
nihonbuson
11
7.3k
Featured
See All Featured
Unsuck your backbone
ammeep
669
57k
The Straight Up "How To Draw Better" Workshop
denniskardys
232
140k
For a Future-Friendly Web
brad_frost
176
9.5k
A better future with KSS
kneath
238
17k
What’s in a name? Adding method to the madness
productmarketing
PRO
22
3.3k
Dealing with People You Can't Stand - Big Design 2015
cassininazir
366
25k
The Pragmatic Product Professional
lauravandoore
32
6.4k
[RailsConf 2023] Rails as a piece of cake
palkan
53
5.2k
Producing Creativity
orderedlist
PRO
344
39k
jQuery: Nuts, Bolts and Bling
dougneiner
63
7.6k
Let's Do A Bunch of Simple Stuff to Make Websites Faster
chriscoyier
507
140k
Writing Fast Ruby
sferik
628
61k
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 ΧδϡΞϧʹ ͯ͠Έ͍ͨ ߹ͪ͜Β ˣ