ドキュメントを修正する

 ドキュメントを修正する

株式会社リンカーズさんの社内勉強会で発表したLTのスライドです

6ac7c50770603b53964d44db373e8e48?s=128

Shinichi Maeshima

April 23, 2018
Tweet

Transcript

  1. υΩϡϝϯτΛमਖ਼͢Δ @willnet

  2. ීஈͷ։ൃɺͳΜΒ͔ͷυΩϡϝϯτ Λݟͳ͕Β։ൃ͠·͢ΑͶ

  3. OSSͷυΩϡϝϯτͷؒҧ͍Λݟ͚ͭͨΒͲ͏͠ ·͔͢ʁ 1. εϧʔ 2. ؒҧ͍Λमਖ਼͢Δɺใࠂ͢Δ

  4. OSSͷυΩϡϝϯτͷؒҧ͍Λݟ͚ͭͨΒͲ͏͠ ·͔͢ʁ 1. ! εϧʔ 2. " ؒҧ͍Λमਖ਼͢Δɺใࠂ͢Δ

  5. OSSͷυΩϡϝϯτ΋ʮ࢓ࣄͰ࢖͏υ Ωϡϝϯτʯͱ͍͏͘͘ΓͰߟ͑Ε͹ Ұॹ

  6. ͨͱ͑͹ࣾ಺ͷυΩϡϝϯτͰؒҧ͍ݟ͚ͭͨΒ ؒ͜͜ҧ͑ͯ·͢Αʔɻͬͯ੠͔͚ͨΓɺαοͱमਖ਼ͨ͠Γ͠ ·͢ΑͶ

  7. ͠·͢ΑͶ…ʁ

  8. ͦΕΛࣾ֎Ͱ΋΍Δ͚ͩ • ࣗ෼͕ͨͪ࢖͍ͬͯΔπʔϧʹࣾ಺΋ࣾ֎΋ͳ͍ • ؒҧ͍Λ์ஔ͍ͯ͠Δͱ୭͔͕ϋϚΔ͔΋

  9. ͔͠͠΍Γํ͕Θ͔Βͳ͍ͱϋʔυϧ ߴ͘ײͦ͡͏

  10. આ໌͠·͢

  11. (༨ஊ)࠷ۙͷ׆ಈใࠂͰ΋͋Δ ࠷ۙRubyॳ৺ऀ޲͚ͷຊΛࠪಡ͍ͯͯ͠ɺ֬ೝͷͨΊʹυΩϡ ϝϯτΛಡΈɺؒҧ͍Λݟ͚ͭͯPR΍IssueΛ࡞Δɺͱ͍͏͜ͱ ΛԿ౓͔΍ͬͯͨͷͰͦͷ׆ಈใࠂͰ΋͋Γ·͢

  12. RubyͷυΩϡϝϯτ(೔ຊޠ) • ΦϒδΣΫτࢦ޲εΫϦϓτݴޠ Ruby ϦϑΝϨϯεϚχϡ Ξϧ • https://docs.ruby-lang.org/ja/latest/doc/index.html • ௨শΔΓ·

    • ࠷଎RubyϦϑΝϨϯεϚχϡΞϧݕࡧʂ | ΔΓ·αʔν • https://docs.ruby-lang.org/ja/search/
  13. ೔ຊޠυΩϡϝϯτ͸GitHubͰ؅ཧ͞Ε͍ͯΔ • https://github.com/rurema/doctree

  14. मਖ਼͚ͨ͠Ε͹Pull Request

  15. ΔΓ·͸೔ຊޠͰPull Request΍Issueͩ͠ ͯ΋େৎ෉ͦ͏

  16. ฤू಺༰Λ֬ೝ͢Δํ๏ • PRલʹɺฤू಺༰ΛHTMLʹͯ֬͠ೝ͢Δඞཁ͕͋Δ • markdown ͳͲमਖ਼ͯ͠΋ݟͨ໨Ͳ͏มΘΔͷ͔Θ͔Γ· ͤΜ • େ఍ͷ৔߹ɺͲ͔͜ʹ΍Γํ͕ॻ͍ͯ͋Δ(READMEͱ͔wiki ͱ͔)

    • ͳ͚Ε͹RakefileΛΈΔͱΑ͍
  17. ΔΓ·ฤूͷ஫ҙ఺

  18. ฤू಺༰Λ֬ೝ͢ΔͨΊͷ৘ใ͕ࢄΒ͹͍ͬͯͯ Θ͔Γʹ͍͘… • ͱΓ͋͑ͣ͜ͷ2͚͓͚֮ͭͩ͑ͯ͹ฤूɺ֬ೝͰ͖ͦ͏ • bundle exec rake statichtml:2.5.0 Έ͍ͨʹ͢Δͱ

    / private/tmp/html ʹϑΝΠϧ͕ग़ྗ͞ΕΔ • /tmp/db-2.5.0 ͳͲʹதؒੜ੒෺ͷDB͕࡞੒͞ΕΔΑ͏ ͳͷͰɺstatichtmlͰมߋ͕ͳ͍৔߹͸DBফͯ͠ϦτϥΠ ͢Δͱྑͦ͞͏
  19. RubyͷυΩϡϝϯτ(ӳޠ) • Documentation for Ruby trunk • https://docs.ruby-lang.org/en/trunk/ • Rubyຊମͷιʔείʔυ͔ΒRDocΛར༻ͯ͠ੜ੒

  20. ӳޠυΩϡϝϯτ͸RDoc ͭ·ΓRubyຊମͷίϝϯτʹຒΊࠐ·Ε͍ͯΔ

  21. मਖ਼͚ͨ͠Ε͹Pull Request • https://github.com/ruby/ruby • جຊతʹ͸redmineͷํ͕ྑ͍͚Ͳɺ؆୯ͳ಺༰ͳΒGitHub Ͱ΋Α͍͸ͣ…ʁ • ྫ: https://github.com/ruby/ruby/pull/1857

  22. ೔ຊޠ൛ɺӳޠ൛υΩϡϝϯτΛϗεςΟϯά͠ ͍ͯΔαʔόͷઃఆ΋GitHubͰ؅ཧ͞Ε͍ͯ· ͢ • https://github.com/ruby/docs.ruby-lang.org

  23. ϦϯΫ੾Εʹͳ͍ͬͯΔՕॴ Λݟ͚ͭͯɺαʔόཁҼͬΆ ͔ͬͨͷͰIssueΛ౤͛ͨਤ • https://github.com/ruby/docs.ruby- lang.org/issues/56

  24. RailsͷެࣜυΩϡϝϯτ • http://api.rubyonrails.org/ • (౰ͨΓલ͚ͩͲ)ӳޠ൛ͷΈ • https://github.com/rails/rails/ • rdocͰੜ੒

  25. RailsΨΠυ • http://guides.rubyonrails.org/ • ຊମίʔυͱಉ͡ϦϙδτϦͰ؅ཧ͞Ε͍ͯΔ • https://github.com/rails/rails/tree/master/guides • markdownܗࣜ

  26. मਖ਼͚ͨ͠Ε͹Pull Request • typoϨϕϧͳΒҰॠͰϚʔδ͞ΕΔ ͜ͱ͕ଟ͍ • [ci skip]Λ๨Εͣʹ

  27. RailsΨΠυ೔ຊޠ൛ • ༗ࢤ(ओʹYassLabࣾ)͕ϝϯς͍ͯ͠Δ • ๻΋ίϛολʔͰ͢ • ެࣜͱͷࠩ෼͔ͳΓ͋ΔͷͰPRνϟϯεͷๅݿ • https://github.com/yasslab/railsguides.jp

  28. मਖ਼͚ͨ͠Ε͹Pull Request • ೔ຊޠͰPR࡞ΕΔͷͰෑډ͕௿͍ • मਖ਼಺༰ͷ֬ೝํ๏΋READMEಡΊ ͹͙͢Ͱ͖·͢

  29. (༨ஊ)ӳޠͰPR΍IssueΛॻ ͘ͱ͖ͷίπ • google຋༁ʹӳޠΛॻ͍ͯɺҙຯ͕ ௨Δ͔֬ೝ • ͜Ε͚ͩͰ͍ͩͿ҆৺Ͱ͖Δ

  30. ·ͱΊ • OSSͷυΩϡϝϯτ΋ɺࣾ಺ͷυΩϡϝϯτͱಉ͡Α͏ʹϝ ϯςφϯε͍͖ͯ͠·͠ΐ͏ • ͍͍ͩͨGitHubͰPull RequestͰ͖·͢ • ͓࡞๏͑͞཈͑Ε͹ɺ͋ͱ͸ࣾ಺ͷυΩϡϝϯτͱಉ͡Α͏ ʹमਖ਼Ͱ͖·͢

  31. (༨ஊ)mac࢖͍ͳΒDashΦεεϝͰ͢

  32. ϩʔΧϧʹඞཁͳυΩ ϡϝϯτΛμ΢ϯϩʔ υ͓͍ͯͯ͠ɺαοͱ ݕࡧͰ͖·͢

  33. $26.99 ͷՁ஋͸͋ΔΑ

  34. happy documantating !