Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Design Doc の書き方 / How to Write a Design Doc (Ja...

Design Doc の書き方 / How to Write a Design Doc (Ja ver.)

「Design doc とは何か」・「何を書けばよいのか」を説明するスライドです。

関連するプレゼンテーション「読みやすいコードの書き方」: https://gist.github.com/munetoshi/65a1b563fb2c271f328c121a4ac63571

© 2023 Munetoshi Ishikawa, supported by LINE corporation

Munetoshi Ishikawa

May 11, 2023
Tweet

More Decks by Munetoshi Ishikawa

Other Decks in Programming

Transcript

  1. τϐοΫ - Design doc ͷ֓ཁ - Design doc ͷߏ੒ -

    ӡ༻࣌ͷ஫ҙ఺ - έʔεελσΟ
  2. τϐοΫ - Design doc ͷ֓ཁ - Design doc ͷߏ੒ -

    ӡ༻࣌ͷ஫ҙ఺ - έʔεελσΟ
  3. Design doc ͷ֓ཁ - Design doc ͱ͸ - ʮԿΛʯॻ͔͘ -

    ʮ͍ͭʯॻ͔͘ - ৄࡉઃܭॻͱͷҧ͍
  4. Design doc ͷ֓ཁ - Design doc ͱ͸ - ʮԿΛʯॻ͔͘ -

    ʮ͍ͭʯॻ͔͘ - ৄࡉઃܭॻͱͷҧ͍
  5. Design doc ͱ͸ 2/2 ࣮૷Λߦ͏લʹॻ͘υΩϡϝϯτ - ࣮૷લʹઃܭʹ͍ͭͯٞ࿦ - ࣮૷த΋ΞοϓσʔτՄ design

    doc ࣮૷ “Twemoji” ©Twitter, Inc and other contributors (Licensed under CC-BY 4.0) https://twemoji.twitter.com/
  6. Design doc ͷ֓ཁ - Design doc ͱ͸ - ʮԿΛʯॻ͔͘ -

    ʮ͍ͭʯॻ͔͘ - ৄࡉઃܭॻͱͷҧ͍
  7. ؔ࿈͢ΔιϦϡʔγϣϯ 1/2 Կɾͳͥ: ࢓༷ɾ໨తͷ໌֬Խ - PRD (Product Requirements Document) ͩΕɾ͍ͭ:

    λεΫɾϚΠϧετʔϯ؅ཧ - Πγϡʔ؅ཧπʔϧɾϓϩδΣΫτ؅ཧπʔϧ

  8. Design doc ͷ֓ཁ - Design doc ͱ͸ - ʮԿΛʯॻ͔͘ -

    ʮ͍ͭʯॻ͔͘ - ৄࡉઃܭॻͱͷҧ͍
  9. ͍ͭ design doc Λॻ͘΂͖͔ (cont.) Design doc Λॻ͘ج४ͷྫ: - 2

    िؒҎ্͔͔ΔλεΫ - ෳ਺ͷϦϦʔεʹ·͕ͨΔϓϩδΣΫτ - ଟ਺ͷϞδϡʔϧɾΫϥεʹӨڹ͢Δमਖ਼
  10. Design doc ͷ֓ཁ - Design doc ͱ͸ - ʮԿΛʯॻ͔͘ -

    ʮ͍ͭʯॻ͔͘ - ৄࡉઃܭॻͱͷҧ͍
  11. ΢ΥʔλʔϑΥʔϧͱͷൺֱ: ڞ௨఺ τοϓμ΢ϯͳΞϓϩʔν - ࣮૷ͷલʹઃܭ - จॻͷϨϏϡʔɾٞ࿦ design doc ࣮૷

    + ϨϏϡʔɾٞ࿦ “Twemoji” ©Twitter, Inc and other contributors (Licensed under CC-BY 4.0) https://twemoji.twitter.com/
  12. τϐοΫ - Design doc ͷ֓ཁ - Design doc ͷߏ੒ -

    ӡ༻࣌ͷ஫ҙ఺ - έʔεελσΟ
  13. యܕతͳ design doc ͷߏ੒ - ໨తɾΰʔϧʢ΄΅ඞਢʣ - എܠ - ઃܭͷ֓ཁ

    - ৄࡉઃܭ - ͦͷଞͷؔ৺ࣄ τοϓμ΢ϯʹཧղͰ͖Δߏ੒ʹ͢Δ
  14. ໨తɾΰʔϧ: ஫ҙ఺ ௕͘ॻ͖͗͢ͳ͍ - ඞཁͳΒ͹ PRD Λผ్༻ҙ - ʮ࣮૷͢ΔՁ஋͕͋Δ͔ʯ΋جຊతʹ͸ PRD

    Ͱٞ࿦ είʔϓΛ໌֬ʹ͢Δ - ඞཁʹԠͯ͡ʮout of scopeʯ΍ʮࠓޙͷ༧ఆʯΛ໌ه
  15. τϐοΫ - Design doc ͷ֓ཁ - Design doc ͷߏ੒ -

    ӡ༻࣌ͷ஫ҙ఺ - έʔεελσΟ
  16. Ξϯνύλʔϯ 1 1. ʮ׬ᘳͳʯ design doc Λॻ্͖͛Δ 2. ϨϏϡʔͷϛʔςΟϯάʹ 10

    ਓҎ্ট଴ 3. ٞ࿦தʹઃܭͷ໰୊͕ൃ֮ 4. ࠷ॳ͔Β design doc Λॻ͖௚͢
  17. ٞ࿦ͷλΠϛϯά ٞ࿦ͱ design doc ࡞੒Λަޓʹߦ͏ ࠷ॳͷٞ࿦͸… - ʮগਓ਺Ͱʯ: ςοΫϦʔυͱͷ 1-on-1

    ͔Β࢝Ίͯ΋Α͍ - ʮղܾҊ͕ͳͯ͘΋ʯ: ٞ࿦ͰղܾҊΛݟ͚ͭΕ͹Α͍ - ʮ΄΅നࢴͰ΋ʯ: ٞࣄ࿥తʹ design doc Λॻ͘͜ͱ͕Ͱ͖Δ
  18. Ξϯνύλʔϯ 3 1. ઃܭมߋͷ౓ʹ design doc Λߋ৽ 2. ʮελʔτΞοϓΨΠυʯͱ͠΋࠶ར༻ 3.

    ଟେͳίετ͕ඞཁʹͳΔ - ৽نϝϯόʔ͸େྔͷ design doc ΛಡΉඞཁ͕͋Δ - ܰඍͳมߋͰ΋େྔͷ design doc ͷߋ৽͕ඞཁʹͳΔ
  19. Design doc ͷ੹೚ൣғ Design doc ͸جຊతʹ͸࢖͍ࣺͯ - 1 ϓϩδΣΫτͰ 1

    design doc - ΞʔΧΠϒ΍ʮܦҢΛ஌Δख͕͔Γʯʹ͸ͳΔ - ଞͷબ୒ࢶΛߟྀ: ΞʔΩςΫνϟจॻɾPRDɾνϡʔτϦΞϧ
  20. ӡ༻࣌ͷ஫ҙ఺: ·ͱΊ - ٞ࿦ɾϨϏϡʔͷαΠΫϧ͸୹Ίʹ - ࣮૷தʹ΋ design doc ͸ߋ৽Մ -

    Design doc ʹʮଞͷ໾ׂʯΛ௥Ճ͠ͳ͍ - ޙ͔Β design doc ΛࢀরͰ͖ΔΑ͏ʹ
  21. τϐοΫ - Design doc ͷ֓ཁ - Design doc ͷߏ੒ -

    ӡ༻࣌ͷ஫ҙ఺ - έʔεελσΟ