README.fi.md

Ensimmäiset kontribuutiot

Se on vaikeaa. Ensimmäiset kerrat ovat aina vaikeita. Etenkin tehdessä yhteistyötä, virheiden teko ei ole ollenkaan mukavaa. Me halusimme yksinkertaistaa tavan jolla avoimen lähdekoodin kontribuoijat oppivat sekä kontribuoivat ensimmäistä kertaa.

Artikkeleiden lukeminen sekä tutoriaalien katsominen voi auttaa, mutta mikä onkaan parempaa kuin käytännön harjoite harjoitusympäristössä? Tämä projekti tähtää avun tarjoamiseen sekä aloittelijoiden ensimmäisen kontribuution yksinkertaistamiseen. Jos olet aikeissa kontribuoida ensimmäistä kertaa, seuraa alla olevia ohjeita.

Jos et osaa käyttää komentoriviä sulavasti, täältä löytyy tutoriaaleja GUI-työkalujen käyttöön.

Jos sinulla ei ole git asennettuna koneellesi, asenna se.

Forkkaa tämä repositorio

Forkkaa tämä repositorio klikkaamalla yläkulmassa näkyvää painiketta "Fork". Tämä luo kopion tästä repositoriosta käyttäjällesi.

Kloonaa repositorio

Seuraavaksi kloonaa juuri forkkaamasi repositorio koneellesi. Mene GitHub käyttäjäsivuillesi, avaa forkkaamasi repositorio sekä klikkaa "Clone or download"-painiketta jonka jälkeen kopioi osoite painamalla "Copy to clipboard"-ikonia.

Avaa komentorivi ja syötä seuraava git-komento:

git clone "Juuri kopioimasi URL"

"Juuri kopioimasi URL"-tekstin sijasta (ilman lainausmerkkejä) pastea repositorion URL äskeisestä vaiheesta.

Esimerkiksi:

git clone https://github.com/nimesi/first-contributions.git

Kirjoita GitHub-käyttäjänimesi 'nimesi' teksin sijaan. Tämä komento kopioi sisällön GitHubisi first contributions-repositorion koneellesi.

Luo branch

Mene repositoriosi kansioon koneellasi (ellet jo ole siellä).

cd first-contributions

Seuraavaksi luo branch komennolla git checkout:

git checkout -b <lisaa-sinun-branchin-nimi>

Esimerkiksi:

git checkout -b add-matti-meikalainen

(Branchin nimeen ei välttämättä tarvitse sisällyttää sanaa add, mutta tässä se käy järkeen sillä tämän branchin tarkoitus on lisätä nimesi listaan.)

Tee tarvittavat muutokset sekä committoi ne

Seuraavaksi avaa Contributors.md tiedosto tekstieditorissa ja lisää nimesi tiedostoon. Älä lisää sitä tiedoston alkuun taikka loppuun vaan keskelle. Seuraaksi tallenna tiedosto.

Jos menet projektin kansioon ja syötät komennon git status, näet muutokset.

Lisää nuo muutokset branchiin git add komennolla:

git add Contributors.md

Seuraavaksi committoi muutokset git commit komennolla:

git commit -m "Add <sinun-nimesi> to Contributors list"

Korvaamalla <sinun-nimesi> nimelläsi.

Muutosten pushaaminen GitHubiin

Pushaa muutoksesi komennolla git push:

git push origin <lisaa-branchisi-nimi>

Korvaamalla <lisaa-branchisi-nimi> nimellä jonka annoit branchillesi aikaisemmin.

Jätä muutoksesi arvosteltavaksi

Jos menet repositorioosi GitHubissa, näet Compare & pull request painikkeen. Paina tuota painiketta.

Seuraavaksi suorita pull request.

Seuraavaksi mergeän muutoksesi tämän projektin master-branchiin. Tulet saamaan ilmoituksen sähköpostiisi kun muutokset ovat mergetty.

Mihin seuraavaksi?

Onneksi olkoon! Olet juuri suorittanut tavanomaisen Fork -> Clone -> Edit -> Pull Request -työnkulun joka tulee vastaasi usein kontribuoijana!

Juhlista kontribuutiotasi ja jaa se ystävillesi ja followereillesi menemällä Web Appiin.

Voit liittyä Slack tiimiimme jos sinulla on kysyttävää. Liity Slack tiimiin.

Jos haluaisit kontribuoida muihin projekteihin, me olemme koonneet listan yksinkertaisista ensimmäisistä issueista työskenneltäväksesi. Lista löytyy Web-Appistamme.

Lisämateriaaleja

Muiden työkalujen tutoriaaleja

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code	Atlassian Sourcetree	IntelliJ IDEA