Skip to content

Latest commit

 

History

History
129 lines (75 loc) · 7.1 KB

README.fi.md

File metadata and controls

129 lines (75 loc) · 7.1 KB

Open Source Love License: MIT Open Source Helpers

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.

fork this repository

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

clone this repository

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.

copy URL to clipboard

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.

git status

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.

create a pull request

Seuraavaksi suorita pull request.

submit 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.

Muiden työkalujen tutoriaaleja

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