Slide 1

Slide 1 text

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

Slide 2

Slide 2 text

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

Slide 3

Slide 3 text

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

Slide 4

Slide 4 text

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

Slide 5

Slide 5 text

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

Slide 6

Slide 6 text

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

Slide 7

Slide 7 text

͠·͢ΑͶ…ʁ

Slide 8

Slide 8 text

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

Slide 9

Slide 9 text

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

Slide 10

Slide 10 text

આ໌͠·͢

Slide 11

Slide 11 text

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

Slide 12

Slide 12 text

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

Slide 13

Slide 13 text

೔ຊޠυΩϡϝϯτ͸GitHubͰ؅ཧ͞Ε͍ͯΔ • https://github.com/rurema/doctree

Slide 14

Slide 14 text

मਖ਼͚ͨ͠Ε͹Pull Request

Slide 15

Slide 15 text

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

Slide 16

Slide 16 text

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

Slide 17

Slide 17 text

ΔΓ·ฤूͷ஫ҙ఺

Slide 18

Slide 18 text

ฤू಺༰Λ֬ೝ͢ΔͨΊͷ৘ใ͕ࢄΒ͹͍ͬͯͯ Θ͔Γʹ͍͘… • ͱΓ͋͑ͣ͜ͷ2͚͓͚֮ͭͩ͑ͯ͹ฤूɺ֬ೝͰ͖ͦ͏ • bundle exec rake statichtml:2.5.0 Έ͍ͨʹ͢Δͱ / private/tmp/html ʹϑΝΠϧ͕ग़ྗ͞ΕΔ • /tmp/db-2.5.0 ͳͲʹதؒੜ੒෺ͷDB͕࡞੒͞ΕΔΑ͏ ͳͷͰɺstatichtmlͰมߋ͕ͳ͍৔߹͸DBফͯ͠ϦτϥΠ ͢Δͱྑͦ͞͏

Slide 19

Slide 19 text

RubyͷυΩϡϝϯτ(ӳޠ) • Documentation for Ruby trunk • https://docs.ruby-lang.org/en/trunk/ • Rubyຊମͷιʔείʔυ͔ΒRDocΛར༻ͯ͠ੜ੒

Slide 20

Slide 20 text

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

Slide 21

Slide 21 text

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

Slide 22

Slide 22 text

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

Slide 23

Slide 23 text

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

Slide 24

Slide 24 text

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

Slide 25

Slide 25 text

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

Slide 26

Slide 26 text

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

Slide 27

Slide 27 text

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

Slide 28

Slide 28 text

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

Slide 29

Slide 29 text

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

Slide 30

Slide 30 text

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

Slide 31

Slide 31 text

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

Slide 32

Slide 32 text

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

Slide 33

Slide 33 text

$26.99 ͷՁ஋͸͋ΔΑ

Slide 34

Slide 34 text

happy documantating !