30
OpenSourcerers because it’s a kind of magic

Open soucerers - jak zacząć swoją przygodę z open source

Embed Size (px)

DESCRIPTION

Jarosław Pałka oraz Konrad Malawski opowiadają o narzędziach i procesach jak rozpocząć swoją przygodę z open source.

Citation preview

Page 1: Open soucerers - jak zacząć swoją przygodę z open source

OpenSourcerersbecause it’s a kind of magic

Page 2: Open soucerers - jak zacząć swoją przygodę z open source

Projekt pieszczochy

Czy ja naprawdę nie mam co robić z wolnym czasem?

Page 3: Open soucerers - jak zacząć swoją przygodę z open source

By three methods we may learn wisdom: First, by reflection, which is noblest; Second, by imitation, which is easiest; and third by experience, which is the bitterest.

Confucius

Page 4: Open soucerers - jak zacząć swoją przygodę z open source

Zalety projektów pieszczochów

● Nie musisz pytać szefa o pozwolenie● Możesz użyć “zabronionych” technologii● Możesz pracować z ludźmi z którymi nigdy nie miałbyś

szansy pracować● Możesz w końcu mieć rację :)● Możesz też nie mieć racji, i czuć się z tym zajebiście :)● … i stać się jeszcze lepszym

Page 5: Open soucerers - jak zacząć swoją przygodę z open source

Co potrzebuje?● Pomysł● Czas● Narzędzia

Page 6: Open soucerers - jak zacząć swoją przygodę z open source

PomysłTylko nie sprawdzaj czy ktoś już na to wpadł,

jedno mogę Ci zagwarantować, ktoś już to zrobił :)

Ale ty możesz zrobić to lepiej :)

Page 7: Open soucerers - jak zacząć swoją przygodę z open source

Czas● Nudne spotkanie :)● Bo się właśnie kompiluje :)● Bezsenność :)● W TV nie ma nic ciekawego :)

Page 8: Open soucerers - jak zacząć swoją przygodę z open source

Narzędzia● Github lub Bitbucket● Travis lub Cloudbees● Sonatype OSS -> Maven Central

Page 9: Open soucerers - jak zacząć swoją przygodę z open source

Przydałby się CI?● Zarejestruj się na Cloudbees, dostaniesz 40

minut za darmo, na początek wystarczy :)● Potrzebujesz więcej?

Przyłącz się do http://www.cloudbees.com/foss/foss-dev.cb

Page 10: Open soucerers - jak zacząć swoją przygodę z open source

Uwolnij swoje artefakty● Załóż konto na

https://issues.sonatype.org/secure/Signup!default.jspa● Zgłoś swój projekt

https://issues.sonatype.org/secure/CreateIssue.jspa?issuetype=21&pid=10134

Page 11: Open soucerers - jak zacząć swoją przygodę z open source

A potem to już tylko...● http://central.sonatype.org/● Aby twój projekt znalazł się w Maven Central

○ Przygotuje klucz PGP,gpg --keyserver hkp://pool.sks-keyservers.net --send-keys

○ i z pomocą maven’amvn release:perform -Darguments="-Dgpg.passphrase=" -P sonatype-oss-release

Page 12: Open soucerers - jak zacząć swoją przygodę z open source

Pamiętaj by twój POM <parent> <groupId>org.sonatype.oss</groupId> <artifactId>oss-parent</artifactId> <version>9</version> </parent>

Page 13: Open soucerers - jak zacząć swoją przygodę z open source

… i jeszcze <description></description>

<licenses></licenses>

<developers></developers>

<scm></scm>

Page 14: Open soucerers - jak zacząć swoją przygodę z open source

● Sign contributor license agreement at https://support.springsource.com/spring_committer_signup

● Fork repository, https://github.com/spring-projects/

● Read “A day in a life of contributor”● And listen to @ktosopl :)

A może by tak “commiter” w Spring?

Page 15: Open soucerers - jak zacząć swoją przygodę z open source

Pull Requesting to Akka

● oraz ogólnie do projektów na github

Page 16: Open soucerers - jak zacząć swoją przygodę z open source

Pull Requesting to Akka

● przeczytaj: README.md○ Linki do mailing list etc.

● przeczytaj: CONTRIBUTING.md○ Jak otwierać issue?○ Jak otwierać pull request?○ Jak opisywać commity?

■ Musi zawierać issue nr etc.

Page 17: Open soucerers - jak zacząć swoją przygodę z open source

Pull Requesting to Akka

● Znajdź issue (np. community contrib):

Page 18: Open soucerers - jak zacząć swoją przygodę z open source

Pull Requesting to Akka

● Upewnij się że rozumiesz task

Page 19: Open soucerers - jak zacząć swoją przygodę z open source

Pull Requesting to Akka

● fork + branch off (master / release-2.3)

Page 20: Open soucerers - jak zacząć swoją przygodę z open source

hakk hakk hakk...

● Branch off: `wip-actor-docs-ktoso`● A potem commit● Niektóre projekty mają strict konwencje

○ Akka wymaga:=doc #1337 Improved Actor docs for Java+act #1242 Added TailChopping Router

Page 21: Open soucerers - jak zacząć swoją przygodę z open source

Pull Request

Page 22: Open soucerers - jak zacząć swoją przygodę z open source

Pull Request

Page 23: Open soucerers - jak zacząć swoją przygodę z open source

Pull Request

Page 24: Open soucerers - jak zacząć swoją przygodę z open source

Update PR == rebase + push --force

● git checkout release-2.3● git pull --rebase akka release-2.3● git co wip-my-thing● git rebase release-2.3

● git commit --amen ● git push --force

Page 25: Open soucerers - jak zacząć swoją przygodę z open source

“Squash PR to one commit”

● git rebase -i release-2.3○ s - squash○ p - pick

● git push --force

Page 26: Open soucerers - jak zacząć swoją przygodę z open source

Pull Request Validation

● Core team operates PR Validator:○ OK TO TEST○ PLS BUILD

Page 27: Open soucerers - jak zacząć swoją przygodę z open source

Pull Request Validation

● Our Validation does tags:○ validating○ needs-attention○ tested

Page 28: Open soucerers - jak zacząć swoją przygodę z open source

Pull Request Validation

jenkins.akka.io:9498

Page 29: Open soucerers - jak zacząć swoją przygodę z open source

Team review, LGTMs

● Looks ● Good● To● Me

Page 30: Open soucerers - jak zacząć swoją przygodę z open source

Kudos!