技術書を書く技術

Ed7cfa6e677273f67096dc8f03c8a671?s=47 tochi
December 22, 2018

 技術書を書く技術

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

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

Ed7cfa6e677273f67096dc8f03c8a671?s=128

tochi

December 22, 2018
Tweet

Transcript

  1. ٕज़ຊΛॻٕ͘ज़ ߹ಉษڧձJOେ౎ձԬࢁ8JOUFS

  2. ࣗݾ঺հ

  3. 5PNPZVLJ 5PDIJIJSB 5XJUUFS!BHVVV (JU)VCUPDIJ ԬࢁݝԬࢁࢢࡏॅ +"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$*ͰจମνΣοΫ ɾ.BSLEPXO3F7*&8ʹม׵ ɾ3F7*&81%'ʹม׵

  20. .BSLEPXOͰॻ͘

  21. ٕज़ຊΛॻ͘ϑϩʔ ɾ.BSLEPXOͰॻ͘ ɾ(JU)VCͰ13࡞ͬͯϨϏϡʔ ɾ$JSDMF$*ͰจମνΣοΫ ɾ.BSLEPXO3F7*&8ʹม׵ ɾ3F7*&81%'ʹม׵

  22. (JU)VCͰ13࡞ͬͯϨϏϡʔ

  23. ٕज़ຊΛॻ͘ϑϩʔ ɾ.BSLEPXOͰॻ͘ ɾ(JU)VCͰ13࡞ͬͯϨϏϡʔ ɾ$JSDMF$*ͰจମνΣοΫ ɾ.BSLEPXO3F7*&8ʹม׵ ɾ3F7*&81%'ʹม׵

  24. $JSDMF$*ͰจମνΣοΫ

  25. ٕज़ຊΛॻ͘ϑϩʔ ɾ.BSLEPXOͰॻ͘ ɾ(JU)VCͰ13࡞ͬͯϨϏϡʔ ɾ$JSDMF$*ͰจମνΣοΫ ɾ.BSLEPXO3F7*&8ʹม׵ ɾ3F7*&81%'ʹม׵

  26. 3F7*&8ͱ͸ʁ 3F7*&8͸ిࢠॻ੶ͱࢴॻ੶ͷͨΊͷɺ؆͔ܿͭڧ ྗͳσδλϧग़൛πʔϧͰ͢ɻίϯϐϡʔλॻ౳ͷٕ ज़ॻ੶ʢࢴɾిࢠʣͷ঎ۀग़൛΍ಉਓग़൛ʹར༻͞ Ε͍ͯ·͢ɻ ࢀߟɿIUUQTHJUIVCDPNLNVUPSFWJFX

  27. 3F7*&8ͷग़ྗܗࣜ ɾ&16# ɾ1%' ɾ*O%FTJHO ɾ)5.- ɾFUDʜ

  28. ٕज़ຊΛॻ͘ϑϩʔ ɾ.BSLEPXOͰॻ͘ ɾ(JU)VCͰ13࡞ͬͯϨϏϡʔ ɾ$JSDMF$*ͰจମνΣοΫ ɾ.BSLEPXO3F7*&8ʹม׵ ɾ3F7*&81%'ʹม׵

  29. .BSLEPXO3F7*&8ʹม׵ NESFWJFX HFNNESFWJFX NESFWJFXDIBQUFSTDIBQUFSNESFWJFXTDIBQUFSSF ࢀߟɿIUUQTHJUIVCDPNUBLBIBTIJNNESFWJFX

  30. ٕज़ຊΛॻ͘ϑϩʔ ɾ.BSLEPXOͰॻ͘ ɾ(JU)VCͰ13࡞ͬͯϨϏϡʔ ɾ$JSDMF$*ͰจମνΣοΫ ɾ.BSLEPXO3F7*&8ʹม׵ ɾ3F7*&81%'ʹม׵

  31. 3F7*&81%'ʹม׵ 3F7*&8 HFNSFWJFX SBLFQEG ࢀߟɿIUUQTHJUIVCDPNLNVUPSFWJFX

  32. 3F7*&81%'ʹม׵ SFWJFXTDBUBMPHZNM 13&%&' $)"14 DIBQUFSSF DIBQUFSSF "11&/%*9 1045%&'

  33. 3F7*&81%'ʹม׵

  34. ٕज़ຊΛॻ͘ϑϩʔ ɾ.BSLEPXOͰॻ͘ ɾ(JU)VCͰ13࡞ͬͯϨϏϡʔ ɾ$JSDMF$*ͰจମνΣοΫ ɾ.BSLEPXO3F7*&8ʹม׵ ɾ3F7*&81%'ʹม׵ IUUQTHJUIVCDPNUPDIJNBLFUFDIOJDBMCPPLTBNQMF

  35. ݁Ռൃද

  36. Զ͕ͨͪ஌Γ͔ͨͬͨ "MFYBͷ࿩ 8SJUFS ɾ5PNPIBSV*UP ɾ5PNPZVLJ5PDIJIJSB ɾ)JEFUBLB0LBNPUP %FTJHOFS ɾ"UTVTIJ"OEP

  37. Զ͕ͨͪ஌Γ͔ͨͬͨ "MFYBͷ࿩ #PPUI IUUQTBMFYBCPPUIQN Φʔϓϯιʔε IUUQTHJUIVCDPNCPPLPGBMFYBBMFYBCBTJD

  38. ചΓ্͛ ࢧग़ ɾٕज़ॻయࢀՃඅɿ=  ɾҹ࡮අɿ= ʢ࡭ʣ ऩೖ ɾٕज़ॻయɿ= ʢ࡭࡭͸ݙຊ༻ʣ ɾٕज़ॻయʢޙ෷͍ʣɿ=

     ɾ#005)ɿ= ʢख਺ྉɿʣ རӹ ɾ߹ܭɿ= 
  39. पғͷ൓Ԡ

  40. पғͷ൓Ԡ ɾຊΛॻ͍͍ͯΔਓͱ͍͏ೝ஌౓ ɾ෺ཧຊͩͱݙຊͰ͖Δ ɾ਌଒͔Β΋࿈བྷ͕͖ͨ ɾग़൛͔ࣾΒ঎ۀग़൛ͷΦϑΝʔ͕͖ͨ

  41. ࣍ͷεςοϓ

  42. ࣍ͷεςοϓ ɾདྷ೥ͷٕज़ॻయͰ΋ൢച ɾষ୯ҐͰബ͍ຊͱͯ͠&16#ͰϦϦʔε ɾ࠷ऴతʹΦϨΞϨʹ౷߹ͯ͠ಷثΛ໨ࢦ͢ ɾ,JOEMF%JSFDU1VCMJTIJOHʢ"NB[PO,JOEMFʣ ɾ3F7*&8ܗࣜͰॻ͍ͯΑΓຊͬΆ͘

  43. ·ͱΊ

  44. ·ͱΊ ɾಉਓࢽͷٕज़ຊΛग़͢ͷ͸೉͘͠ͳ͍ ɾٕज़ຊΛॻ͘͜ͱͰٕज़ྗ΋͕͋Δ ɾ*5ܥ͡Όͳ͍ਓʹ΋ΠϯύΫτ͕͋Δ

  45. -FU`TFOKPZXSJUJOH