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
55
Other Decks in Technology
See All in Technology
2/18 Making Security Scale: メルカリが考えるセキュリティ戦略 - Coincheck x LayerX x Mercari
jsonf
0
110
Raycast AI APIを使ってちょっと便利な拡張機能を作ってみた / created-a-handy-extension-using-the-raycast-ai-api
kawamataryo
0
200
OPENLOGI Company Profile for engineer
hr01
1
20k
大規模アジャイルフレームワークから学ぶエンジニアマネジメントの本質
staka121
PRO
3
680
「正しく」失敗できる チームの作り方 〜リアルな事例から紐解く失敗を恐れない組織とは〜 / A team that can fail correctly
i35_267
4
770
What's new in Go 1.24?
ciarana
1
100
Apache Iceberg Case Study in LY Corporation
lycorptech_jp
PRO
0
280
MIMEと文字コードの闇
hirachan
2
1.4k
分解して理解する Aspire
nenonaninu
2
880
Autonomous Database Serverless 技術詳細 / adb-s_technical_detail_jp
oracle4engineer
PRO
17
45k
Snowflakeの開発・運用コストをApache Icebergで効率化しよう!~機能と活用例のご紹介~
sagara
1
380
偏光画像処理ライブラリを作った話
elerac
1
160
Featured
See All Featured
Navigating Team Friction
lara
183
15k
BBQ
matthewcrist
87
9.5k
RailsConf & Balkan Ruby 2019: The Past, Present, and Future of Rails at GitHub
eileencodes
133
33k
Making the Leap to Tech Lead
cromwellryan
133
9.1k
Large-scale JavaScript Application Architecture
addyosmani
511
110k
I Don’t Have Time: Getting Over the Fear to Launch Your Podcast
jcasabona
32
2.1k
Mobile First: as difficult as doing things right
swwweet
223
9.4k
Understanding Cognitive Biases in Performance Measurement
bluesmoon
27
1.6k
Build The Right Thing And Hit Your Dates
maggiecrowley
34
2.5k
Designing Experiences People Love
moore
140
23k
RailsConf 2023
tenderlove
29
1k
GraphQLの誤解/rethinking-graphql
sonatard
68
10k
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 ΧδϡΞϧʹ ͯ͠Έ͍ͨ ߹ͪ͜Β ˣ