ドキュメント作成どうしてる？

納品物としての仕様書について思っていること

Transcript

1. Documentation
   @griffin_stewie
   

   View Slide

2. Fenrir Inc.
   @griffin_stewie
   Bouldering: Level 5
   

   View Slide

3. υΩϡϝϯτ࡞੒Ͳ͏ͯ͠Δʁ
   

   View Slide

4. Target
   • डୗ։ൃࣄۀ
   • ೲ඼෺
   

   View Slide

5. Ͳ͏΍ͬͯΔʁ
   

   View Slide

6. Format
   • Excel / Word
   • HTML
   • PDF
   

   View Slide

7. Excel / Word
   • ݹདྷΑΓ఻ΘΔҋٕज़
   • ΤϯδχΞʹݏΘΕ͕ͪ
   

   View Slide

8. • ࢓༷ॻ.xls
   • ࢓༷ॻ_࠷৽.xls
   • ࢓༷ॻ_ࠩ෼.xls
   • ࢓༷ॻ_࠷৽_2016-01-27.xls
   • ࢓༷ॻ_phase2.xls
   

   View Slide

9. View Slide

10. HTML
    • खॻ͖͸πϥΠ
    • ग़དྷΔ͜ͱ͕ଟ͍
    • Git ϑϨϯυϦʔ
    

    View Slide

11. PDF
    • ผͷϑΥʔϚοτ͔Βੜ੒
    • ݩϑΥʔϚοτྫ
    • Markdown
    • AsciiDoc
    • HTML
    • Git ϑϨϯυϦʔ
    

    View Slide

12. ٻΊ͍ͯΔ΋ͷ
    

    View Slide

13. Expects
    • ࢴͬΆ͍ମࡋ
    • ؀ڥґଘ͠ͳ͍
    • iOS ΞϓϦσϕϩού͕ Office Λ࣋ͬͯΔͱࢥ͏ͳΑ
    • ࠩ෼ൃੜ࣌ͷࠩ෼֬ೝ
    

    View Slide

14. ͜͏ͳΒ͍͍ͳ
    

    View Slide

15. Dream
    • αʔόू໿ͳ HTML
    • ؆୯ʹ୭Ͱ΋ฤूͰ͖Δ
    • αʔνՄೳ
    • ϦϏδϣϯ؅ཧ
    • PDF ΤΫεϙʔτ
    

    View Slide

16. Line up
    • Sphinx
    • Read The Doc
    • GitBook
    

    View Slide

17. Կ͔͍͍ͷͳ͍ʁ
    

    View Slide