実践 OSSことはじめ / First Step for OSS Contribution

Transcript

1. 1.

   ࣮ફ OSS͜ͱ͸͡Ί Masashi Hirano (@shisama)

2. 2.

   ฏ໺ ণ࢜ / Masashi Hirano @shisama_ shisama Node.js Core Collaborator

3. 3.

   λʔήοτ • OSSߩݙʹؔ৺͕ͳ͍ਓ • OSSߩݙʹؔ৺͸͋Δ͚ͲɺͲ͏͢Ε͹͍͍͔Θ͔Βͳ͍ਓ

4. 4.

   ͜ͷLTͷΰʔϧ • OSSߩݙʹগ͠Ͱ΋ؔ৺Λ΋ͬͯ΋Β͏ • OSSߩݙͷ۩ମతΠϝʔδΛ΋ͬͯ΋Β͏ ্هΛୡ੒ʹࢲͷܦݧ͕໾ʹཱͯ͹خ͍͠

5. 5.

   OSSߩݙ͸Կ͔Β࢝ΊΕ͹͍͍ͷ…?

6. 6.

   ߩݙ͢ΔOSSͷϧʔϧΛ஌Ζ͏ • ҎԼ͕͋Ε͹ඞͣಡ΋͏ • ߦಈنൣ (Code of Conduct) ϋϥεϝϯτ͸͠ͳ͍͜ͱͳͲ౰ͨΓલͷ͜ͱ͕ॻ͔Ε͍ͯΔ͜ͱ͕ଟ͍ •

   ίϯτϦϏϡʔγϣϯΨΠυ (CONTRIBUTING.md) ίϛοτϝοηʔδͷॻ͖ํ΍ʮίϛοτલ͸ςετΛ࣮ߦ͠·͠ΐ͏ʯͱ͔΍ Δ͜ͱ͕ॻ͔Ε͍ͯΔ
7. 7.

   issue • όάใࠂ • ݪҼ͸Θ͔Βͳͯ͘΋όά͔΋ͱࢥͬͨΒissueొ࿥ • ػೳཁ๬ • ࡞ऀɾϝϯςφ͸Ϣʔβʔͷ੠Λ଴͍ͬͯ·͢

8. 8.

   υΩϡϝϯτͷमਖ਼ • typo • misspell (github.com/client9/misspell) Λ࢖͑͹ίϚϯυҰൃͰݟ͔ͭΔ • ףࢺɻ’the the

   ‘Ͱgrep͢ΔɻGrammarlyͳͲจ๏νΣοΧʔΛ࢖͏ • දݱ • ෆ໌ྎͳจষͷॻ͖௚͠ • ੍͕࣌લޙͰ߹Θͳ͍จষͷमਖ਼
9. 9.

   υΩϡϝϯτͷमਖ਼ • αϯϓϧίʔυ • υΩϡϝϯτ΍READMEʹ࢖͍ํ͕ࡌ͍ͬͯͳ͍ͱ͖͸αϯ ϓϧίʔυΛ௥Ճ • αϯϓϧίʔυ͸ςετίʔυ͔Βഈआ • मਖ਼લʹissueͰ࣭໰ͯ͠Έͯ΋ྑ͍

10. 10.

    υΩϡϝϯτͷ຋༁ https://github.com/gatsbyjs/gatsby-ja/issues/1

11. 11.

    ςετίʔυ • ΧόϨοδΛݟͯςετΛ௥Ճ͢Δ • ৽ػೳ͸ΧόϨοδ͕௿͍ • ෆ҆ఆͳςετ(flaky test)Λमਖ਼͢Δʢ೉қ౓ߴΊʣ • ςετίʔυ͔ΒֶͿ͜ͱ͸ଟ͍

    https://coverage.nodejs.org/
12. 12.

    ґଘϥΠϒϥϦͷΞοϓσʔτ • ϥΠϒϥϦΛΞοϓσʔτͯ͠ςετΛ௨͢ • ϝδϟʔόʔδϣϯͷΞοϓσʔτ͸೉͍͠ • ݹ͍ϥΠϒϥϦΛ࠷ۙͷϥΠϒϥϦʹஔ͖׵͑ • e.g. TSLint

    -> ESLintɺrequest -> axios
13. 13.

    OSS׳Ε͖ͯͨͷͰίʔυΛ৮Γ͍ͨΜ͕ͩ…

14. 14.

    όάमਖ਼ • ૝ఆ֎ͷ஋ͷόϦσʔγϣϯ௥Ճ • null͕Ҿ਺ʹ͘Δ͜ͱ͕૝ఆ͞Ε͍ͯͳ͍͜ͱ͸Α͋͘Δ • ϥΠϒϥϦʹύονΛ౰ͯΔલʹຊՈʹPull RequestΛૹΖ͏ • ϥΠϒϥϦʹಠࣗύονΛ౰ͯΔӡ༻ͩͱϥΠϒϥϦͷΞοϓσʔτ࣌ʹύονͷमਖ਼

    ͕ඞཁʹͳΔ • ηΩϡϦςΟύον • ੬ऑੑใࠂͳͲͷݪҼ͕OSSʹ͋ͬͨ৔߹͸issueΛొ࿥͢Δ
15. 15.

    ػೳ௥Ճ • ͜Ε͕͋ͬͨΒศརͱࢥͬͨػೳ͸issueͰఏҊͯ͠ΈΔ • Ϣʔεέʔε΍ࠔ͍ͬͯΔ͜ͱΛΘ͔Γ΍͘͢ॻ͘ • ଞͷOSS΍ݴޠʹ͋ΔػೳΛఏҊͯ͠ΈΔ • ಺෦ͰͷΈ࢖͍ͬͯͨػೳΛެ։͢Δ

16. 16.

    ಺෦ͰͷΈ࢖͍ͬͯͨػೳΛެ։͢Δ ಺෦Ͱ͔͠࢖ΘΕ͍ͯͳ͔ͬͨ ςετ༻ͷศརؔ਺Λ APIͱͯ͠ެ։͍ͯ͠Δ https://github.com/nodejs/node/issues/32912

17. 17.

    ϦϑΝΫλϦϯά • ݴޠ΍ϥΠϒϥϦͷݹ͍ػೳΛॻ͖׵͑Δ • JSͷ৔߹ɺasync/await΍Ξϩʔؔ਺, let/constͳͲ • Deprecated ͳػೳΛॻ͖׵͑Δ •

    ܕΛ෇͚Δ • JavaScript -> TypeScript ॻ͖׵͑ʢࣄલʹ߹ҙͳͲ͸ඞཁʣ • any ΛͪΌΜͱͨ͠ܕʹॻ͖׵͑Δ • ܕ͕ແ͍ϥΠϒϥϦ͸d.tsΛ࡞ͬͨΓDefinitelyTyped (@types/xxx) ʹܕΛొ࿥
18. 18.

    OSS׆ಈͷোนʹͳΓ΍͍͢ͱ͜Ζ

19. 19.

    ӳޠ • Google ຋༁ɺDeepLͰશવ௨͡Δ • ૬ख΋ӳޠݍͰ͸ͳ͍͜ͱ΋͋ΔͷͰɺؾʹ͠ͳͯ͘ྑ͍ • μϒϧΫΥʔςʔγϣϯͰғͬͯݕࡧͯ݅͠਺ΛݟΔ

20. 20.

    OSSʹׂ͕࣌ؒ͘ͳ͍ https://cybozu-oss-policy.readthedocs.io/ja/latest/index.html αΠϘ΢ζ͸ۀ຿தʹOSS׆ಈ͢Δ͜ͱ͕ೝΊΒΕ͍ͯΔ https://cybozu-oss-policy.readthedocs.io/ja/latest/index.html

21. 21.

    ͲΜͳOSSʹߩݙ͢Ε͹͍͍͔Θ͔Βͳ͍ FEνʔϜ͸OSSͷωλΛஷΊ͍ͯͨΓɺ ίϯτϦϏϡʔγϣϯΛ؅ཧ͍ͯ͠ΔͷͰ೷͍ͯΈ͍ͯͩ͘͞ʂ૬ஊ΋ঝΓ·͢ʂʂ

22. 22.

    ·ͱΊ • OSS΁ͷߩݙํ๏͸༷ʑ • αΠϘ΢ζ͸OSS׆ಈ͢Δͷʹྑ͍؀ڥ • ؆୯ͳ΋ͷ͔Β࢝Ί·͠ΐ͏ʂ

23. 23.

    Thanks. @shisama_ shisama