Googleに学ぶDesign Docs / Learn from Google on Design Docs

Notes

"Design Docs at Google"
https://www.industrialempathy.com/posts/design-docs-at-google/

"Scaling Engineering Teams via RFCs: Writing Things Down - The Pragmatic Engineer"
https://blog.pragmaticengineer.com/scaling-engineering-teams-via-writing-things-down-rfcs/

"ADR(Architecture Decision Record)"
https://github.com/joelparkerhenderson/architecture_decision_record

"All Design Projects Should Start in a Google Doc"
https://www.tedgoas.com/blog/design-in-google-docs/

"どのようにPlatformチームの組織変更をしたか"
https://engineering.mercari.com/blog/entry/2020-07-16-083548/

"Production Readiness Checklist at Mercari"
https://github.com/mercari/production-readiness-checklist

Transcript

1. (PPHMFʹֶͿ%FTJHO
   %PDT !.BLVBLF
   -5
   1BSUZ
   
2. !NOVNB@
   גࣜձࣾϚΫΞέ
   5FBN
   43&
3. %FTJHO
   %PDT
4. %FTJHO
   %PDT
   㲈
   ઃܭॻ
   ϝϧΧϦࣾ
   #PME$IBMMFOHF
   Ͱ%FTJHO
   %PDTจ Խʹ͍ͭͯ஌ͬͨɻ(PPHMFͷϓϥΫςΟεͱͯ͠ ΋஌ΒΕ͍ͯΔɻ
   %FTJHO
   %PDT
   BU
   (PPHMF
   ͱ͍͏ϒϩάهࣄʹ ͯ಺༰͕ղઆ͞Ε͍ͯͨͷͰ͜ΕΛݩʹ঺հɻ
   IUUQTXXXJOEVTUSJBMFNQBUIZDPNQPTUTEFTJHO EPDTBUHPPHMF
   %FTJHO
   %PDT
5. %FTJHO
   %PDT
   BU
   (PPHMF
6. %FTJHO
   %PDT͕(PPHMFͰͲͷΑ͏ʹػೳ͍ͯ͠Δ͔ʁ
   ઃܭ্ͷ໰୊Λૣظʹಛఆग़དྷΔ
   
   ૊৫಺ͷίϯηϯαε͕औΕΔ
   
   ԣஅతؔ৺ࣄͷߟྀΛߦ͏ࣄ͕ग़དྷΔ
   
   ্ڃΤϯδχΞͷφϨοδΛ޿͛ΒΕΔ
   
   ઃܭ্ͷܾఆʹؔ͢Δه࿥ʹͳΔ
   
   ઃܭऀͷςΫχΧϧϙʔτϑΥϦΦͷ੒Ռ෺ʹͳΔ
7. %FTJHO
   %PDTͷߏ଄ ɾ$POUFYU
   BOE
   TDPQF
   
   ֓ཁ
   ɾ(PBMT
   BOE
   OPOHPBMT
   ໨ඪͱ໨ඪͰͳ͍΋ͷ
   ɾ5IF
   BDUVBM
   EFTJHO
   ઃܭ
   
   ɾ4ZTUFNDPOUFYUEJBHSBN
   γεςϜίϯςΩετਤ
   ɾ"1*
   
   ɾ%BUB
   TUPSBHF
   σʔλετϨʔδ
   ɾ$PEF
   BOE
   QTFVEPDPEF
   
   ίʔυ΍ٖࣅίʔυ
   ɾ%FHSFF
   PG
   DPOTUSBJOU
   ੍໿
   ɾ"MUFSOBUJWFT
   DPOTJEFSFE
   ୅ସҊ
   ɾ$SPTTDVUUJOH
   DPODFSOT ԣஅతؔ৺
8. %FTJHO
   %PDTͷߏ଄ ɾ$POUFYU
   BOE
   TDPQF
   
   ֓ཁ
   ɾ(PBMT
   BOE
   OPOHPBMT
   ໨ඪͱ໨ඪͰͳ͍΋ͷ
   ɾ5IF
   BDUVBM
   EFTJHO
   ઃܭ
   
   ɾ4ZTUFNDPOUFYUEJBHSBN
   γεςϜίϯςΩετਤ
   ɾ"1*
   
   ɾ%BUB
   TUPSBHF
   σʔλετϨʔδ
   ɾ$PEF
   BOE
   QTFVEPDPEF
   
   ίʔυ΍ٖࣅίʔυ
   ɾ%FHSFF
   PG
   DPOTUSBJOU
   ੍໿
   ɾ"MUFSOBUJWFT
   DPOTJEFSFE
   ୅ସҊ
   ɾ$SPTTDVUUJOH
   DPODFSOT ԣஅతؔ৺
9. %FTJHO
   %PDTͷߏ଄ ɾ$POUFYU
   BOE
   TDPQF
   
   ֓ཁ
   ɾ(PBMT
   BOE
   OPOHPBMT
   ໨ඪͱ໨ඪͰͳ͍΋ͷ
   ɾ5IF
   BDUVBM
   EFTJHO
   ઃܭ
   
   ɾ4ZTUFNDPOUFYUEJBHSBN
   γεςϜίϯςΩετਤ
   ɾ"1*
   
   ɾ%BUB
   TUPSBHF
   σʔλετϨʔδ
   ɾ$PEF
   BOE
   QTFVEPDPEF
   
   ίʔυ΍ٖࣅίʔυ
   ɾ%FHSFF
   PG
   DPOTUSBJOU
   ੍໿
   ɾ"MUFSOBUJWFT
   DPOTJEFSFE
   ୅ସҊ
   ɾ$SPTTDVUUJOH
   DPODFSOT ԣஅతؔ৺
10. %FTJHO
    %PDTͷߏ଄ ɾ$POUFYU
    BOE
    TDPQF
    
    ֓ཁ
    ɾ(PBMT
    BOE
    OPOHPBMT
    ໨ඪͱ໨ඪͰͳ͍΋ͷ
    ɾ5IF
    BDUVBM
    EFTJHO
    ઃܭ
    
    ɾ4ZTUFNDPOUFYUEJBHSBN
    γεςϜίϯςΩετਤ
    ɾ"1*
    
    ɾ%BUB
    TUPSBHF
    σʔλετϨʔδ
    ɾ$PEF
    BOE
    QTFVEPDPEF
    
    ίʔυ΍ٖࣅίʔυ
    ɾ%FHSFF
    PG
    DPOTUSBJOU
    ੍໿
    ɾ"MUFSOBUJWFT
    DPOTJEFSFE
    ୅ସҊ
    ɾ$SPTTDVUUJOH
    DPODFSOT ԣஅతؔ৺ طଘγεςϜͳͲ͕བྷΉγεςϜ্ͷ੍໿ࣄ߲
    ˞
    (SFFOpFME
    
    %FWFMPQNFOU
    WT
    #SPXOpFME
    
    %FWFMPQNFOU
    IUUQTTZOPQUFLDPNJOTJHIUTJUCMPHTHSFFOpFMEWTCSPXOpFMETPGUXBSFEFWFMPQNFOU
11. %FTJHO
    %PDTͷߏ଄ ɾ$POUFYU
    BOE
    TDPQF
    
    ֓ཁ
    ɾ(PBMT
    BOE
    OPOHPBMT
    ໨ඪͱ໨ඪͰͳ͍΋ͷ
    ɾ5IF
    BDUVBM
    EFTJHO
    ઃܭ
    
    ɾ4ZTUFNDPOUFYUEJBHSBN
    γεςϜίϯςΩετਤ
    ɾ"1*
    
    ɾ%BUB
    TUPSBHF
    σʔλετϨʔδ
    ɾ$PEF
    BOE
    QTFVEPDPEF
    
    ίʔυ΍ٖࣅίʔυ
    ɾ%FHSFF
    PG
    DPOTUSBJOU
    ੍໿
    ɾ"MUFSOBUJWFT
    DPOTJEFSFE
    ୅ସҊ
    ɾ$SPTTDVUUJOH
    DPODFSOT ԣஅతؔ৺ ηΩϡϦςΟɺϓϥΠόγʔɺՄ؍ଌੑͳͲ
    (PPHMFͰ͸ϓϥΠόγʔͱηΩϡϦςΟʹ͸ઐ༻ͷ
    ϨϏϡʔϓϩηε͕ଘࡏ͢Δɻ
    
12. %FTJHO
    %PDTͷߏ଄ ɾ$POUFYU
    BOE
    TDPQF
    
    ֓ཁ
    ɾ(PBMT
    BOE
    OPOHPBMT
    ໨ඪͱ໨ඪͰͳ͍΋ͷ
    ɾ5IF
    BDUVBM
    EFTJHO
    ઃܭ
    
    ɾ4ZTUFNDPOUFYUEJBHSBN
    γεςϜίϯςΩετਤ
    ɾ"1*
    
    ɾ%BUB
    TUPSBHF
    σʔλετϨʔδ
    ɾ$PEF
    BOE
    QTFVEPDPEF
    
    ίʔυ΍ٖࣅίʔυ
    ɾ%FHSFF
    PG
    DPOTUSBJOU
    ੍໿
    ɾ"MUFSOBUJWFT
    DPOTJEFSFE
    ୅ସҊ
    ɾ$SPTTDVUUJOH
    DPODFSOT ԣஅతؔ৺
    ৄࡉͰ͋Δඞཁ͕͋Δ͕
    ؆ܿʹॻ͍ͯ͋Δ͜ͱ͕େࣄʂ
13. %FTJHO
    %PDTΛॻ͔ͳ͍ͱ͍͏͜ͱ جຊతʹ͸ΦʔόʔϔουʹͳΔ͕ɺ૊৫ίϯηϯαεΛऔΕΔར఺͕ΦʔόʔϔουΛ্ճΔΑ͏ͳ Βॻ͍ͯΔɻ໰୊ͷෳࡶ͞ʹ΋ΑΔɺτϨʔυΦϑ΍୅ସҊ͕ͳ͍γϯϓϧͳ՝୊ͳΒॻ͔ͳ͍ɻ
    ϓϩτλΠϐϯά΍εΫϥϜ։ൃͱͷ૬ੑʹ͍ͭͯɻط஌ͷ໰୊ͷղܾʹͳΔ৔߹͕͋Δɻ
    ϓϩτλΠϐϯάࣗମ͕%FTJHO
    %PDͷҰ෦Ͱ͋Δ
    l*
    USJFE
    JU
    PVU
    BOE
    JU
    XPSLTz
    ͕ͦ͜ઃܭɻ
14. ϥΠϑαΠΫϧ 
    ࡞੒
    
    ϨϏϡʔ
    
    ࣮૷ͱ൓෮
    
    ϝϯςφϯεͱֶश
    
    
    
15. ϥΠϑαΠΫϧ 
    ࡞੒
    
    ϨϏϡʔ
    
    ࣮૷ͱ൓෮
    
    ϝϯςφϯεͱֶश
    
    
    (PPHMFυΩϡϝϯτͰ࡞Δɻ
16. ϥΠϑαΠΫϧ 
    ࡞੒
    
    ϨϏϡʔ
    
    ࣮૷ͱ൓෮
    
    ϝϯςφϯεͱֶश
    
    
    νʔϜΛ௒͑ͨ෯޿͍ਓ͕ର৅ʹͳΔɻ
    σΟεΧογϣϯ͸ओʹυΩϡϝϯτͷίϝϯτΛ࢖͏ɻ
    ΈΜͳ͜ͷϨϏϡʔ޲͚ͷ࣌ؒΛఆظతʹ཈͑ͯΔɻ
    ઃܭऀʹͱͬͯ͸Φʔόϔουʹ΋ͳΔͷͰॏཁͳϑΟʔυ όοΫΛ௚઀ٻΊͨΓͳͲॊೈʹௐ੔ͯ͠Δɻ
    ੲ͸ϝʔϦϯάϦετʹૹ৴ͯࣗ͠༝ʹϨϏϡʔ͕ͯͨ͠ݶ քΛܴ͑ͨɻ
17. ϥΠϑαΠΫϧ 
    ࡞੒
    
    ϨϏϡʔ
    
    ࣮૷ͱ൓෮
    
    ϝϯςφϯεͱֶश
    
    
    ܽ఺΍ରॲ͞Ε͍ͯͳ͍ཁ݅ɺਪଌ͕ؒҧ͍ͬͯΔ͜ͱ͕൑ ໌͠ઃܭͷมߋ͕ඞཁʹͳΔ͜ͱ͸ආ͚ΕΕ·ͤΜɻ
    ৭ʑ͋ͬͯผͳυΩϡϝϯτʹ෼཭͞ΕΔ͜ͱ΋Α͋͘Γ· ͢ɻ
18. ϥΠϑαΠΫϧ 
    ࡞੒
    
    ϨϏϡʔ
    
    ࣮૷ͱ൓෮
    
    ϝϯςφϯεͱֶश
    
    
    (PPHMFͷΤϯδχΞ͸৮Εͨ͜ͱͷͳ͍γεςϜʹ৮Δͱ ͖ɺ%FTJHO
    %PDTΛ֬ೝ͠·͢ɻ
    ͕࣌ͨͬͯဃ཭ͯ͠Δ͜ͱ΋͋Δ͕γεςϜΛֶͿͷʹ໾ཱ ͭ͜ͱ͕ଟ͍ɻ
19. ϥΠϑαΠΫϧ 
    ࡞੒
    
    ϨϏϡʔ
    
    ࣮૷ͱ൓෮
    
    ϝϯςφϯεͱֶश
    
    
    ͨ·ʹಡΈฦ͍ͯͩ͘͠͞ɻਖ਼͍͜͠ͱ͸͋Γ·͔͢ʁؒ ҧ͍ͬͯΔ͜ͱ͸͋Γ·͔͢ʁ͍·ͩͬͨͲ͏͍͏ܾஅΛ͠ ·͔͢ʁΤϯδχΞͱͯ͠ਐา͠ɺ࣌ؒͷܦաͱͱ΋ʹιϑ τ΢ΣΞઃܭεΩϧΛ޲্ͤ͞ΔͨΊͷ༏Εͨํ๏Ͱ͢ɻ
20. ϥΠϑαΠΫϧ 
    ࡞੒
    
    ϨϏϡʔ
    
    ࣮૷ͱ൓෮
    
    ϝϯςφϯεͱֶश
    
    
    ࠔ೉ͳ໰୊ղܾ΍ίϯηϯαεΛಘΔͷʹ࠷దͳํ๏ͱͯ͠ ׆༻͍ͯ͠Δɻ
21. पลٞ࿦ 6CFS
    &3%T
    &OHJOFFSJOH
    3FWJFX
    %PDT
    4DBMJOH
    &OHJOFFSJOH
    5FBNT
    WJB
    3'$T
    8SJUJOH
    5IJOHT
    %PXO
    
    5IF
    1SBHNBUJD
    &OHJOFFS
    IUUQTCMPHQSBHNBUJDFOHJOFFSDPNTDBMJOHFOHJOFFSJOHUFBNTWJBXSJUJOHUIJOHTEPXOSGDT
    IUUQTUXJUUFSDPN(FSHFMZ0SPT[TUBUVT
    "%3 "SDIJUFDUVSF
    %FDJTJPO
    3FDPSE
    IUUQTHJUIVCDPNKPFMQBSLFSIFOEFSTPOBSDIJUFDUVSF@EFDJTJPO@SFDPSE
    "MM
    %FTJHO
    1SPKFDUT
    4IPVME
    4UBSU
    JO
    B
    (PPHMF
    %PD
    IUUQTXXXUFEHPBTDPNCMPHEFTJHOJOHPPHMFEPDT
22. ϝϧΧϦʹ͓͚Δ%FTJHO
    %PDT ͲͷΑ͏ʹ1MBUGPSNνʔϜͷ૊৫มߋΛ͔ͨ͠
    IUUQTFOHJOFFSJOHNFSDBSJDPNCMPHFOUSZ
    4FSWJDF
    %FTJHO
    %PD
    ςϯϓϨʔτ
    IUUQTHJUIVCDPNNFSDBSJQSPEVDUJPOSFBEJOFTTDIFDLMJTU
    ɾ4-0
    ɾ1**