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

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

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

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

griffin-stewie

January 28, 2016
Tweet

More Decks by griffin-stewie

Other Decks in Programming

Transcript

  1. Documentation
    @griffin_stewie

    View full-size slide

  2. Fenrir Inc.
    @griffin_stewie
    Bouldering: Level 5

    View full-size slide

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

    View full-size slide

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

    View full-size slide

  5. Ͳ͏΍ͬͯΔʁ

    View full-size slide

  6. Format
    • Excel / Word
    • HTML
    • PDF

    View full-size slide

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

    View full-size slide

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

    View full-size slide

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

    View full-size slide

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

    View full-size slide

  11. ٻΊ͍ͯΔ΋ͷ

    View full-size slide

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

    View full-size slide

  13. ͜͏ͳΒ͍͍ͳ

    View full-size slide

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

    View full-size slide

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

    View full-size slide

  16. Կ͔͍͍ͷͳ͍ʁ

    View full-size slide