技術書を書く技術

合同勉強会 in 大都会岡山 2018 Winter
https://gbdaitokai.connpass.com/event/96596/

技術本を作る技術 · aguuu.com https://www.aguuu.com/archives/2018/09/make_technical_book/

Transcript

1. ٕज़ຊΛॻٕ͘ज़ ߹ಉษڧձJOେ౎ձԬࢁ
   
   8JOUFS
2. ࣗݾ঺հ
3. 5PNPZVLJ
   5PDIJIJSB 5XJUUFS
   !BHVVV
   (JU)VC
   UPDIJ
   ԬࢁݝԬࢁࢢࡏॅ
   +"846(
   Ԭࢁ
   ίΞϝϯόʔ
   ""+6(
   גࣜձࣾ%*(*5"-+&5ʢ෺ཧࣾһʣ
   גࣜձࣾιχοΫΨʔσϯʢ࿦ཧࣾһʣ
4. ຊΛॻ͘ཧ༝
5. ຊΛॻ͘ཧ༝ Χζ͞Μ ΤϯδχΞ͸ιϑτ΢ΣΞ͸࡞ΕΔ͚Ͳ෺ཧతʹखͰ৮Δ ϞϊΛ࡞Δ͜ͱ͕Ͱ͖ͳ͍ΑͶɻͰ΋ɺٕज़ຊͳΒ๻Βͷ ஌ࣝΛ෺ཧతͳϞϊͱͯ͠࢒ͤΔ͔Βຊॻ͍ͯΈ͍ͨΑͶɻ
6. େࣄͳ৺ಘ
7. େࣄͳ৺ಘ ෛ͚ͳ͍৺
   ౤͛ग़͞ͳ͍৺
   ಀ͛ग़͞ͳ͍৺
8. ४උ
9. ४උ ɾ঎ۀग़൛
   ɹɾ"NB[PO΍ॻళʹฒͿ
   ɹɾઍ෦͕໨҆
   ɹɾҹ੫͸ൢചՁ֨ͷʙ
   ɹɾ஫໨౓ͷߴ͍ٕज़
   ɹɾग़൛ͷϓϩ͕αϙʔτ
   ɹɾྲྀ௨ܦ࿏͕๛෋
10. ४උ ɾಉਓग़൛
    ɹɾ޷͖ͳํ๏ͰൢചͰ͖Δ
    ɹɾঢ়گΛݟͯ෦਺Λݕ౼
    ɹɾχονͳٕज़ɺ޷͖ͳٕज़ʹϑΥʔΧε
    ɹɾࣥච͔Βग़൛·Ͱͷظ͕ؒ୹͍
    ɹɾग़൛ͷྲྀΕΛ׬શʹ೺Ѳ
11. ४උ ɾڵຯɺ஌͍ͬͯΔٕज़Λॻ͖ग़͢
    ɾ஥ؒΛ୳͢
    ɾຊͷํ޲ੑΛܾΊΔ
    ɾ໨࣍Λॻ͖ग़͢
    ɾؤுͬͯॻ͘ɺͻͨ͢Βॻ͘ɺͱʹ͔͘ॻ͘
12. ٕज़ຊͷࡇయ
13. ٕज़ॻయ̑ ɾٕज़ॻͷΈΛൢച͢Δຊͷࡇయ
    ɾ౦ژͰय़ͱळͷճ։࠵
    ɾ঎ۀɾಉਓͲͪΒͰ΋Մ
    ɾདྷ৔ऀ਺
    ɹ ਓ
    ɾग़ళऀ
    ɹɹνʔϜ
    ɾग़൛෦਺
    ɹ ෦ ࢀߟɿIUUQTIJLBLVKPIPDPNNBOFLBJFOUSZ
14. ٕज़ॻయ̑ ࢀߟɿIUUQTUFDICPPLGFTUPSHFWFOUUCGDJSDMFDIFDLMJTU
15. ٕज़ॻయ̑ ࢀߟɿIUUQTUFDICPPLGFTUPSHFWFOUUCGDJSDMFDIFDLMJTU
16. ٕज़ॻయ̑ ࢀߟɿIUUQTUFDICPPLGFTUPSHFWFOUUCGDJSDMFDIFDLMJTU
17. ٕज़ຊΛॻٕ͘ज़
18. ಉਓࢽͷҹ࡮ ɾ༻ࢴαΠζ
    ɹɾจষ͕த৺ͳΒίϯύΫτͳ"
    ɹɾίʔυ͕ଟ͍৔߹͸ԣ͕௕͍#
    ɾೲ඼σʔλ
    ɹɾ1%'ʢຊจʣ
    PS
    &14ʢഎදࢴʣ
    ɾҹ࡮ํ๏
    ɹɾΦϑηοτͷελϯμʔυϑϧΧϥʔ ࢀߟɿIUUQXXXOJLLPQDDPN
19. ٕज़ຊΛॻ͘ϑϩʔ ɾ.BSLEPXOͰॻ͘
    ɾ(JU)VCͰ13࡞ͬͯϨϏϡʔ
    ɾ$JSDMF$*ͰจମνΣοΫ
    ɾ.BSLEPXO
    
    3F7*&8ʹม׵
    ɾ3F7*&8
    
    1%'ʹม׵
20. .BSLEPXOͰॻ͘
21. ٕज़ຊΛॻ͘ϑϩʔ ɾ.BSLEPXOͰॻ͘
    ɾ(JU)VCͰ13࡞ͬͯϨϏϡʔ
    ɾ$JSDMF$*ͰจମνΣοΫ
    ɾ.BSLEPXO
    
    3F7*&8ʹม׵
    ɾ3F7*&8
    
    1%'ʹม׵
22. (JU)VCͰ13࡞ͬͯϨϏϡʔ
23. ٕज़ຊΛॻ͘ϑϩʔ ɾ.BSLEPXOͰॻ͘
    ɾ(JU)VCͰ13࡞ͬͯϨϏϡʔ
    ɾ$JSDMF$*ͰจମνΣοΫ
    ɾ.BSLEPXO
    
    3F7*&8ʹม׵
    ɾ3F7*&8
    
    1%'ʹม׵
24. $JSDMF$*ͰจମνΣοΫ
25. ٕज़ຊΛॻ͘ϑϩʔ ɾ.BSLEPXOͰॻ͘
    ɾ(JU)VCͰ13࡞ͬͯϨϏϡʔ
    ɾ$JSDMF$*ͰจମνΣοΫ
    ɾ.BSLEPXO
    
    3F7*&8ʹม׵
    ɾ3F7*&8
    
    1%'ʹม׵
26. 3F7*&8ͱ͸ʁ 3F7*&8͸ిࢠॻ੶ͱࢴॻ੶ͷͨΊͷɺ؆͔ܿͭڧ ྗͳσδλϧग़൛πʔϧͰ͢ɻίϯϐϡʔλॻ౳ͷٕ ज़ॻ੶ʢࢴɾిࢠʣͷ঎ۀग़൛΍ಉਓग़൛ʹར༻͞ Ε͍ͯ·͢ɻ ࢀߟɿIUUQTHJUIVCDPNLNVUPSFWJFX
27. 3F7*&8ͷग़ྗܗࣜ ɾ&16#
    ɾ1%'
    ɾ*O%FTJHO
    ɾ)5.-
    ɾFUDʜ
28. ٕज़ຊΛॻ͘ϑϩʔ ɾ.BSLEPXOͰॻ͘
    ɾ(JU)VCͰ13࡞ͬͯϨϏϡʔ
    ɾ$JSDMF$*ͰจମνΣοΫ
    ɾ.BSLEPXO
    
    3F7*&8ʹม׵
    ɾ3F7*&8
    
    1%'ʹม׵
29. .BSLEPXO
    
    3F7*&8ʹม׵ NESFWJFX 
    HFN
    NESFWJFX
    
    NESFWJFX
    DIBQUFSTDIBQUFSNE
    
    SFWJFXTDIBQUFSSF
    ࢀߟɿIUUQTHJUIVCDPNUBLBIBTIJNNESFWJFX
30. ٕज़ຊΛॻ͘ϑϩʔ ɾ.BSLEPXOͰॻ͘
    ɾ(JU)VCͰ13࡞ͬͯϨϏϡʔ
    ɾ$JSDMF$*ͰจମνΣοΫ
    ɾ.BSLEPXO
    
    3F7*&8ʹม׵
    ɾ3F7*&8
    
    1%'ʹม׵
31. 3F7*&8
    
    1%'ʹม׵ 3F7*&8 
    HFN
    SFWJFX
    
    SBLF
    QEG
    ࢀߟɿIUUQTHJUIVCDPNLNVUPSFWJFX
32. 3F7*&8
    
    1%'ʹม׵ 
    SFWJFXTDBUBMPHZNM
    13&%&'
    $)"14
    
    
    
    DIBQUFSSF
    
    
    
    DIBQUFSSF
    "11&/%*9
    1045%&'
    
33. 3F7*&8
    
    1%'ʹม׵
34. ٕज़ຊΛॻ͘ϑϩʔ ɾ.BSLEPXOͰॻ͘
    ɾ(JU)VCͰ13࡞ͬͯϨϏϡʔ
    ɾ$JSDMF$*ͰจମνΣοΫ
    ɾ.BSLEPXO
    
    3F7*&8ʹม׵
    ɾ3F7*&8
    
    1%'ʹม׵
    IUUQTHJUIVCDPNUPDIJNBLFUFDIOJDBMCPPLTBNQMF
35. ݁Ռൃද
36. Զ͕ͨͪ஌Γ͔ͨͬͨ
    "MFYBͷ࿩ 8SJUFS
    ɾ5PNPIBSV
    *UP
    ɾ5PNPZVLJ
    5PDIJIJSB
    ɾ)JEFUBLB
    0LBNPUP
    %FTJHOFS
    ɾ"UTVTIJ
    "OEP
    
37. Զ͕ͨͪ஌Γ͔ͨͬͨ
    "MFYBͷ࿩ #PPUI
    IUUQTBMFYBCPPUIQN
    Φʔϓϯιʔε
    IUUQTHJUIVCDPNCPPLPGBMFYBBMFYBCBTJD
38. ചΓ্͛ ࢧग़
    ɾٕज़ॻయࢀՃඅɿ= 
    ɾҹ࡮අɿ= ʢ࡭ʣ
    ऩೖ
    ɾٕज़ॻయɿ= ʢ࡭
    ࡭͸ݙຊ༻ʣ
    ɾٕज़ॻయʢޙ෷͍ʣɿ= 
    ɾ#005)ɿ= ʢख਺ྉɿʣ
    རӹ
    ɾ߹ܭɿ= 
    
39. पғͷ൓Ԡ
40. पғͷ൓Ԡ ɾຊΛॻ͍͍ͯΔਓͱ͍͏ೝ஌౓
    ɾ෺ཧຊͩͱݙຊͰ͖Δ
    ɾ਌଒͔Β΋࿈བྷ͕͖ͨ
    ɾग़൛͔ࣾΒ঎ۀग़൛ͷΦϑΝʔ͕͖ͨ
41. ࣍ͷεςοϓ
42. ࣍ͷεςοϓ ɾདྷ೥ͷٕज़ॻయͰ΋ൢച
    ɾষ୯ҐͰബ͍ຊͱͯ͠&16#ͰϦϦʔε
    ɾ࠷ऴతʹΦϨΞϨʹ౷߹ͯ͠ಷثΛ໨ࢦ͢
    ɾ,JOEMF
    %JSFDU
    1VCMJTIJOHʢ"NB[PO
    ,JOEMFʣ
    ɾ3F7*&8ܗࣜͰॻ͍ͯΑΓຊͬΆ͘
43. ·ͱΊ
44. ·ͱΊ ɾಉਓࢽͷٕज़ຊΛग़͢ͷ͸೉͘͠ͳ͍
    ɾٕज़ຊΛॻ͘͜ͱͰٕज़ྗ΋͕͋Δ
    ɾ*5ܥ͡Όͳ͍ਓʹ΋ΠϯύΫτ͕͋Δ
45. -FU`T
    FOKPZ
    XSJUJOH